Changes between Version 20 and Version 21 of Documentation/Howto/OptimizeExternalApplications

Timestamp:

09/22/10 17:32:24 (14 years ago)

Author:

abeham

Comment:

changed to reflect new library version

Documentation/Howto/OptimizeExternalApplications

@@ -46 +46 @@
 === Providing an evaluation service ===
 
-The following class diagram displays the classes and interfaces present in the java service framework. There is an abstract base class `Channel` on the one hand which provides methods for sending and receiving messages and several concrete implementations and on the other hand an abstract base class `Service` that provides the concrete `PollService` and `PushService`. Each Channel has a corresponding factory which implements `IChannelFactory`.
-
-[[Image(ExternalEvaluationServiceCD.png)]]
-
-In the source you will also find some test applications that provide very simple examples of how to use the service framework. They do not really evaluate a solution, but return a random number in the interval [0;1) for every received solution.
-
-[[Image(ExternalEvaluationServiceTestCD.png)]]
-
+Attached to this wiki page you can find a java library that enables a quick connection with HeuristicLab over a TCP/IP connection. In this library there is an abstract base class `Channel` on the one hand which provides methods for sending and receiving messages and several concrete implementations and on the other hand an abstract base class `Service` that provides the concrete `PollService` and `PushService`. A `Listener` listens for connections and opens several channels out of which the service will receive solutions and send back qualities. As a user of the library you will prepare an `IListenerFactory` and hand this to your service instance. Then, depending on the type of service, you can get solutions out of it and push the qualities back. It is quite easy.
+
+Similarly a C# port of this library has also been added, which is handy when your application cannot be compiled to a dll and called directly from your C# problem plugin.
+
+In the following code sample you may find some test applications that provide very simple examples of how to use the service framework. They do not really evaluate a solution, but return a random number in the interval [0;1) for every received solution.
 
 ==== Usage examples ====
 
-Here is the java code for the `RandomStreamingPollEvaluator`
+Here is the java code for the `RandomSocketPollEvaluator`
 
 {{{#!java
-public class RandomStreamingPollEvaluator {
+public class RandomSocketPollEvaluator {
 
         public static void main(String[] args) {
-                StreamChannelFactory factory = new StreamChannelFactory(System.in, System.out);
+                ServerSocketListenerFactory factory = new ServerSocketListenerFactory(8842);
                 PollService service = new PollService(factory, 1);
                 service.start();
@@ -70 +67 @@
                 while (true) {
                         SolutionMessage msg = service.getSolution();
-                        // parse the message and retrieve the variables there
                         try {
                                 service.sendQuality(msg, random.nextDouble());
                         } catch (IOException e) {
-                                break;
+                                e.printStackTrace();
                         }
                 }
-                
-                service.stop();
         }
 }
@@ -93 +87 @@
                 main.run();
                 System.out.println("Service is running, terminate by pressing <Return> or <Enter>.");
-                System.console().readLine();
+                System.console().readLine(); // note: you may not always have a console
                 main.terminate();
         }
         
         private void run() {
-                ServerSocketChannelFactory factory = new ServerSocketChannelFactory(8843);
+                ServerSocketListenerFactory factory = new ServerSocketListenerFactory(8842);
                 service = new PushService(factory, 1, new RandomEvaluator());
                 service.start();