Como en casi todas las aplicaciones y herramientas de desarrollo, el mejor lugar para empezar es con un simple ejemplo de "Hello World!" La aplicación habitual de Java Hello World se ejecuta, imprime Hello World y se apaga. Tal vez esto no sea muy interesante para demostrar la capacidad de una herramienta para ejecutar y monitorear servicios. En el caso del Java Service Wrapper, se necesita un ejemplo que se puede instalar, configurarse como un Servicio de Windows o como Demonio UNIX y seguir ejecutandose.

Esta página describe nuestra aplicación de ejemplo Hello World Server, además de ayudarle en el proceso de construcción. La página "¿Cómo puedo ejecutar mi aplicación Java como un Servicio de Windows?" mostrará como usar la aplicación de ejemplo y enseñarle paso a paso la configuración e instalación rápida para poder ejecutarla como un Servicio de Windows haciendo uso del Java Service Wrapper.

Esta aplicación de ejemplo Hello World inicia un subproceso demonio, el cual recibe información del puerto 9000 para clientes basados en forma de texto, que se conectan vía telnet. Esto simplemente imitará cualquier tipo de entrada recibida hasta que se encuentre la entrada exit, en cuyo punto se cerrará la conexión específica.

Si bien esto es un poco más complicado que el ejemplo típico de Hello World, le permite ejecutar una aplicación de servidor fácil, pudiendo interactuar con un programa cliente, siguiendo el modelo de diseño de cliente de servidor fundamental.

Con el propósito de mantener nuestro ejemplo claro y dejarle trabajar con facilidad, por favor inicie con un directorio vacío en la ubicación que desee. En el ejemplo lo llamaremos %HELLO_HOME%. Por favor cree los subdirectorios lib\classes y src\java dentro de %HELLO_HOME%, como sigue:

%HELLO_HOME%\
  lib\
    classes\
  src\
    java\

El siguiente paso es crear un archivo en el directorio src\java llamado HelloWorldServer.java y abrirlo en un editor. Copie la siguiente fuente en dicho archivo y guárdelo.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.OutputStreamWriter;
import java.net.ServerSocket;
import java.net.Socket;

public class HelloWorldServer
    implements Runnable
{
    private final Socket m_socket;
    private final int m_num;

    HelloWorldServer( Socket socket, int num )
    {
        m_socket = socket;
        m_num = num;
        
        Thread handler = new Thread( this, "handler-" + m_num );
        handler.start();
    }
    
    public void run()
    {
        try
        {
            try
            {
                System.out.println( m_num + " Connected." );
                BufferedReader in = new BufferedReader( new InputStreamReader( m_socket.getInputStream() ) );
                OutputStreamWriter out = new OutputStreamWriter( m_socket.getOutputStream() );
                out.write( "Welcome connection #" + m_num + "\n\r" );
                out.flush();
                
                while ( true )
                {
                    String line = in.readLine();
                    if ( line == null )
                    {
                        System.out.println( m_num + " Closed." );
                        return;
                    }
                    else
                    {
                        System.out.println( m_num + " Read: " + line );
                        if ( line.equals( "exit" ) )
                        {
                            System.out.println( m_num + " Closing Connection." );
                            return;
                        }
                        //else if ( line.equals( "crash" ) )
                        //{
                        //    System.out.println( m_num + " Simulating a crash of the Server..." );
                        //    Runtime.getRuntime().halt(0);
                        //}
                        else
                        {
                            System.out.println( m_num + " Write: echo " + line );
                            out.write( "echo " + line + "\n\r" );
                            out.flush();
                        }
                    }
                }
            }
            finally
            {
                m_socket.close();
            }
        }
        catch ( IOException e )
        {
            System.out.println( m_num + " Error: " + e.toString() );
        }
    }
    
    public static void main( String[] args )
        throws Exception
    {
        int port = 9000;
        if ( args.length > 0 )
        {
            port = Integer.parseInt( args[0] );
        }
        System.out.println( "Accepting connections on port: " + port );
        int nextNum = 1;
        ServerSocket serverSocket = new ServerSocket( port );
        while ( true )
        {
            Socket socket = serverSocket.accept();
            HelloWorldServer hw = new HelloWorldServer( socket, nextNum++ );
        }
    }
}

La aplicación inicia y empieza a "escuchar" en el puerto 9000 para conexiones remotas desde cualquier fuente. Cada vez que se acepta una conexión nueva, se crea un subproceso controlador para encargarse de toda la comunicación relacionada con la conexión hasta que ésta se cierre.

El subproceso controlador leerá e imitará (repetirá) cualquier línea de texto como respuesta al cliente. Si una línea de texto conteniendo solo la palabra exites recibida, la conexión del cliente se terminará.

Generar el ejemplo es muy simple. Comience abriendo el Símbolo del Sistema (o Shell en UNIX), acceda al directorio >%HELLO_HOME% que previamente se creó usando el comando cd.

El ejemplo ahora se puede compilar usando el siguiente comando:

javac -d lib\classes src\java\HelloWorldServer.java

Si recibe un error de que el comando javac no fue encontrado, asegúrese de tener instalado un Java SDK en su sistema. Si todo ha ido bien, entonces debe obtener el símbolo del sistema de nuevo sin ninguna salida adicional después de que se complete la compilación.

Verifique para asegurarse de que el archivo de clase se creó ejecutando:

dir lib\classes

Felicidades, ha construido exitosamente el ejemplo de HelloWorldServer.

La ejecución de la aplicación puede hacerse usando el siguiente comando desde el directorio %HELLO_HOME%.

java -classpath lib\classes HelloWorldServer

Si todo está en orden, verá algo como lo siguiente:

Accepting connections on port: 9000

telnet localhost 9000

Welcome connection #1
Test
echo Test
Hello there world!
echo Hello there world!

    ...
    System.out.println( m_num + " Read: " + line );
    if ( line.equals( "exit" ) )
    {
        System.out.println( m_num + " Closing Connection." );
        return;
    }
    else if ( line.equals( "crash" ) )
    {
        System.out.println( m_num + " Simulating a crash of the Server..." );
        Runtime.getRuntime().halt(0);
    }
    else
    {
        System.out.println( m_num + " Write: echo " + line );
        out.write( "echo " + line + "\n\r" );
        out.flush();
    }
    ...