SocketProvidedDescriptor.java

Go to the documentation of this file.

/*
 *   DENOPTIM
 *   Copyright (C) 2022 Marco Foscato <marco.foscato@uib.no>
 *
 *   This program is free software: you can redistribute it and/or modify
 *   it under the terms of the GNU Affero General Public License as published
 *   by the Free Software Foundation, either version 3 of the License, or
 *   (at your option) any later version.
 *
 *   This program is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *   GNU Affero General Public License for more details.
 *
 *   You should have received a copy of the GNU Affero General Public License
 *   along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
package denoptim.fitness.descriptors;
 
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.PrintWriter;
import java.net.Socket;
 
import org.openscience.cdk.exception.CDKException;
import org.openscience.cdk.interfaces.IAtomContainer;
import org.openscience.cdk.qsar.AbstractMolecularDescriptor;
import org.openscience.cdk.qsar.DescriptorSpecification;
import org.openscience.cdk.qsar.DescriptorValue;
import org.openscience.cdk.qsar.IMolecularDescriptor;
import org.openscience.cdk.qsar.result.DoubleResult;
import org.openscience.cdk.qsar.result.DoubleResultType;
import org.openscience.cdk.qsar.result.IDescriptorResult;
 
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.JsonObject;
import com.google.gson.JsonSyntaxException;
 
import denoptim.constants.DENOPTIMConstants;
import denoptim.fitness.IDenoptimDescriptor;
 
 
// WARNING: any change to the format convention for the communication to the 
// socket server must be reflected in the RequestHandler of the unit test.
 
public class SocketProvidedDescriptor extends AbstractMolecularDescriptor 
implements IMolecularDescriptor, IDenoptimDescriptor
{
    private final int version = 1;
 
    public final static String KEYJSONMEMBERSMILES = "SMILES";
    
    public final static String KEYJSONMEMBERSCORE = "SCORE";
    
    public final static String KEYJSONMEMBERERR = "ERROR";
    
    private String hostname;
    
    private Integer port;
    
    private static final String[] PARAMNAMES = new String[] {
            "hostname","port"};
 
    private static final String[] NAMES  = {"SocketProvidedDescriptor"};
 
//------------------------------------------------------------------------------
    
    public SocketProvidedDescriptor() {}
 
//------------------------------------------------------------------------------
      
    @Override
    public DescriptorSpecification getSpecification()
    {
        String paramID = ""; 
        if (hostname!=null && port!=null)
        {
            paramID = "" + hostname + port;
        }
        return new DescriptorSpecification("Denoptim source code", 
                this.getClass().getName(), paramID, "DENOPTIM project");
    }
 
//------------------------------------------------------------------------------
    
    @Override
    public String[] getParameterNames() {
        return PARAMNAMES;
    }
 
//------------------------------------------------------------------------------
    
    @Override
    public Object getParameterType(String name)
    {
        if (name.equals(PARAMNAMES[1])) //port
        {
            return 0;
        } else if (name.equals(PARAMNAMES[0])) // hostname
        {
            return "";
        } else {
            throw new IllegalArgumentException("No parameter for name: "+name);
        }
    }
    
//------------------------------------------------------------------------------
 
    @Override
    public void setParameters(Object[] params) throws CDKException
    {
        if (params.length != 2)
        {
            throw new IllegalArgumentException("SocketProvidedDescriptor only "
                    + "expects two parameter");
        }
        if (!(params[0] instanceof String))
        {
            throw new IllegalArgumentException("Parameter is not String (" 
                    + params[0].getClass().getName() + ").");
        }
        if (!(params[1] instanceof Integer))
        {
            throw new IllegalArgumentException("Parameter is not Integer (" 
                    + params[0].getClass().getName() + ").");
        }
 
        hostname = (String) params[0];
        port = (Integer) params[1];
    }
 
//------------------------------------------------------------------------------
 
    @Override
    public Object[] getParameters()
    {
        Object[] params = new Object[2];
        params[0] = hostname;
        params[1] = port;
        return params;
    }
 
//------------------------------------------------------------------------------
 
    @Override
    public String[] getDescriptorNames()
    {
        return NAMES;
    }
 
//------------------------------------------------------------------------------
 
    @Override
    public DescriptorValue calculate(IAtomContainer mol)
    {
        Socket socket;
        try
        {
            socket = new Socket(hostname, port);
        } catch (IOException e1)
        {
            throw new IllegalArgumentException("Could not connect to socket",e1);
        }
        
        Runtime.getRuntime().addShutdownHook(new Thread(){public void run(){
            try {
                socket.close();
            } catch (IOException e) { /* failed */ }
        }});
        
        PrintWriter writerToSocket;
        try
        {
            OutputStream outputSocket = socket.getOutputStream();
            writerToSocket = new PrintWriter(outputSocket, true);
        } catch (IOException e1)
        {
            try
            {
                socket.close();
            } catch (IOException e)
            {
                e.printStackTrace();
            }
            throw new IllegalArgumentException("Could not connect to socket",e1);
        }
        
        BufferedReader readerFromSocket;
        try
        {
            InputStream inputFromSocket = socket.getInputStream();
            readerFromSocket = new BufferedReader(
                    new InputStreamReader(inputFromSocket));
        } catch (IOException e1)
        {
            try
            {
                socket.close();
            } catch (IOException e)
            {
                e.printStackTrace();
            }
            throw new IllegalArgumentException("Could not read from socket",e1);
        }
        
        JsonObject jsonObj = new JsonObject();
        Object smilesProp = mol.getProperty("SMILES");
        if (smilesProp==null)
        {
            try
            {
                socket.close();
            } catch (IOException e)
            {
                e.printStackTrace();
            }
            throw new IllegalArgumentException("AtomContainers fed to " 
                    + this.getClass().getName() + " are expected to contain "
                            + "property '" + KEYJSONMEMBERSMILES 
                            + "', but it was not found.");
        }
        jsonObj.addProperty("SMILES", smilesProp.toString());
        jsonObj.addProperty("version", version);
        
        // So far there is no need of DENOPTIM's customized Gson builder.
        Gson jsonConverted = new GsonBuilder().create();
        
        // Here we send the request to the socket
        writerToSocket.println(jsonConverted.toJson(jsonObj));
        try
        {
            socket.shutdownOutput();
        } catch (IOException e1)
        {
            try
            {
                socket.close();
            } catch (IOException e)
            {
                // At this point the socket is probably closed already...
            }
            throw new IllegalStateException("Could not half-close socket from "
                    + this.getClass().getName(),e1);
        }
        
        JsonObject answer = null;
        DoubleResult result;
        Exception potentialProblem = null;
        try {
            answer = jsonConverted.fromJson(readerFromSocket.readLine(), 
                    JsonObject.class);
            if (answer.has(KEYJSONMEMBERSCORE))
            {
                double value = Double.parseDouble(
                        answer.get(KEYJSONMEMBERSCORE).toString());
                result = new DoubleResult(value);
            } else if (answer.has(KEYJSONMEMBERERR)) {
                result = new DoubleResult(Double.NaN);
                mol.setProperty(DENOPTIMConstants.MOLERRORTAG, 
                        answer.get(KEYJSONMEMBERERR).toString());
            } else {
                System.err.println("ERROR: Socket server replied without "
                        + "providing either " + KEYJSONMEMBERSCORE + " or "
                        + KEYJSONMEMBERERR + " member. Setting desctriptor "
                        + "'" + NAMES[0] + "'to NaN.");
                
                result = new DoubleResult(Double.NaN);
                potentialProblem = new Exception(
                        "Wrong syntax in answer from socket server."); 
            }
        } catch (JsonSyntaxException | IOException e) {
            e.printStackTrace();
            result = new DoubleResult(Double.NaN);
            potentialProblem = e;
        }
        
        try
        {
            socket.close();
        } catch (IOException e)
        {
            e.printStackTrace();
        }
        
        return new DescriptorValue(getSpecification(),
                getParameterNames(),
                getParameters(),
                result,
                getDescriptorNames(),
                potentialProblem);
    }
 
//------------------------------------------------------------------------------
   
    @Override
    public IDescriptorResult getDescriptorResultType()
    {
        return new DoubleResultType();
    }
 
//------------------------------------------------------------------------------
 
    @Override
    public String getDictionaryTitle()
    {
        return "Socket-provided descriptor";
    }
    
//------------------------------------------------------------------------------
    
    @Override
    public String getDictionaryDefinition()
    {
        return "We ignore how the descriptor is calculated. We only know we "
                + "can ask a socket server for a score. The connection can be "
                + "parametrized so that we can define that a server is "
                + "reachable at host name <code>" + PARAMNAMES[0] + "</code>, "
                + "and port <code>" + PARAMNAMES[1] + "</code>. By convention, "
                + "the communication deploys a JSON string. "
                + "Such format is expected for both "
                + "the request for a score (the request generated by "
                + "DENOPTIM, i.e., the client) and for "
                + "the answer to such request (produced by the "
                + "server). The requst contains always the SMILES of the "
                + "candidate (e.g., "
                + "<code>{\"" + KEYJSONMEMBERSMILES + "\": \"CCO\"}</code>). "
                + "The answer may "
                + "contain a <code>" + KEYJSONMEMBERSCORE + "</code> "
                + "or an <code>" + KEYJSONMEMBERERR + "</code> "
                + "(e.g., <code>{\"" + KEYJSONMEMBERSCORE + "\": 1.23}</code>). "
                + "Failure in the "
                + "communication protocol will produce a <code>NaN</code> "
                + "score.";
    }
 
//------------------------------------------------------------------------------
 
    @Override
    public String[] getDictionaryClass()
    {
        return new String[] {"molecular"};
    }
 
//------------------------------------------------------------------------------
 
}