Java es un idioma de programación muy difundido, fácil de aprender e independiente de una plataforma. En la versión estándar incluye ya todas las clases y métodos, que se necesitan para la programación de aplicaciones TCP/IP. Esto caracteriza a Java como una apreciada herramienta para crear aplicaciones, que comunican con el Web-IO Digital.
Además de un ambiente actual Java no se necesitan otros recursos para ejecutarla.
El siguiente ejemplo de programa permite supervisar y dirigir un Web-IO 2x Digital y pone a disposición las siguientes funciones:
Conectar los Outputs
leer manual o automáticamente Inputs, Outputs y contadores
Leer y borrar contadores individuales o todos juntos
¿No tiene todavía un Web-IO y quiere probar el ejemplo presentado?
no hay problema: Le ponemos a disposición el Web-IO Digital 2xInput, 2xOutput PoE gratis durante 30 días. Rellene sencillamente un pedido muestra y le enviaremos el Web-IO para probar a cuenta abierta. Si nos devuelve el aparato dentro de los 30 días, le abonamos la factura completa.
dotado con una dirección IP - con WuTility no hay problemas.
Resumen de los diferentes elementos de mando y de indicación
En la siguiente figura los diferentes elementos de mando y de indicación han sido titulados con el nombre usado en el código de programa. La asignación deber servir como referencia y facilitar así el determinar el ejemplo siguiente.
Al denominar cada uno de los objetos, es de gran ayuda usar nombres con sentido. En este ejemplo la primera parte del nombre describe la clase de objeto y la segunda la función.
1. Importar las fuentes necesitadas
Al comienzo de cada programa tienen que importarse todas las fuentes necesitadas.
La clase "Cliente" recibe todas las propiedades de la clase "JFrame" para representar la ventana de programa e incluye las interfaces "ActionListener" (Reconocimiento de sucesos de botón), "KeyListener" (Reconocimiento de cambios en campos de texto) y "Runnable" (permiten Threads) mediante la importación de sus métodos.
public class Client extends JFrame implements ActionListener,
KeyListener, Runnable {
...
}
3. Instanciamiento de los elementos gráficos
Para los elementos gráficos (Buttons, CheckBoxes, Label, Panel, TextFields) se crean instancias globales para que estén disponibles en cada método del programa
private JButton jbConnect = new JButton("Connect");
private JButton jbDisconnect = new JButton("Disconnect");
private JButton jbOutputsRead = new JButton("Read all");
private JButton jbInputsRead = new JButton("Read all");
private JButton jbCounterRead0 = new JButton("Read");
private JButton jbCounterRead1 = new JButton("Read");
private JButton jbCounterReadAll = new JButton("Read");
private JButton jbCounterClear0 = new JButton("Clear");
private JButton jbCounterClear1 = new JButton("Clear");
private JButton jbCounterClearAll = new JButton("Clear");
private JCheckBox jcbCounterPolling = new JCheckBox("Polling");
private JCheckBox jcbOutput0 = new JCheckBox("Output 0");
private JCheckBox jcbOutput1 = new JCheckBox("Output 1");
private JCheckBox jcbOutputPolling = new JCheckBox("Polling");
private JCheckBox jcbInput0 = new JCheckBox("Input 0");
private JCheckBox jcbInput1 = new JCheckBox("Input 1");
private JCheckBox jcbInputPolling = new JCheckBox("Polling");
private JLabel jlStatusBar = new JLabel("No connection");
private JPanel jpIO = new JPanel();
private JTextField jtfInterval = new JTextField("250");
private JTextField jtfCounter0 = new JTextField("0");
private JTextField jtfCounter1 = new JTextField("0");
private JTextField jtfIP = new JTextField();
private JTextField jtfPort = new JTextField("80");
private JTextField jtfPassword = new JTextField();
4. Elementos para la transmisión de datos y el comportamiento temporal
Para la transmisión de datos a través de una interfaz de zócalo se utilizan en este ejemplo instancias de las clases "InputStream", "OutputStream" y "Socket".
El Timer, que dirige el Polling, se deriva de la clase "Timer" (javax.swing.Timer).
private Timer tiPoll;
5. El método "main"
El método "main" se llama automáticamente al arrancar el programa. Llama al Constructor de la clase.
public static void main(String[] args) {
new Client();
}
6. El Constructor
En el Constructor se definen tamaño, posición y comportamiento de los elementos de indicación y la venta de programa. El Constructor se llama sin entrega de parámetros.
public Client() {
...
}
A continuación se crea el JPanel "jpIO". Para ello se dimensiona el elemento de indicación, o se desactiva, para crear el estado de partida, y se equipa con un Listener, para que pueda reaccionar a entradas del usuario. Por último se añaden los elementos al JPanel.
El siguiente fragmento de programa crea los elementos de mando y de indicación, que se resumen en la superficie con el concepto "Connection Control". El JPanel, al que se añaden estos elementos, está localmente instanciado, pues fuera del Constructor no se puede acceder más a él.
JLabel jlIP = new JLabel("IPAddress");
jlIP.setBounds(20, 40, 120, 20);
La barra de estado informa durante el desarrollo del programa del estado de la unión de zócalo a un Web-IO. Ya durante el instanciamiento se le asignó el valor de Default "No Connection". En el Constructor se define la representación en forma de tamaño, posición y tipo del marco.
Finalmente se determinan las características de la ventana y se añaden los elementos anteriormente creados. Como último paso se visualiza la ventana de programa. La fase de inicialización está así concluida y el programa está ahora listo para el servicio.
Procesamiento de sucesos (en general): Si se registró un ActionListener en los elementos de indicación y de mando (p. ej. botones y campos de texto), se llama el método "actionPerformed" con sucesos activados. El parámetro entregado incluye entre otros la información, de qué componente ha disparado el suceso.
public void actionPerformed(ActionEvent arg0) {
...
}
Conexión: Pulsando la superficie de contacto "Connect" se inicia una conexión al Web-IO indicado. Los elementos de mando y de indicación se conectar según el estado a activo o inactivo y la barra de estado refleja el punto de avance de la conexión. Si se abrió bien el zócalo y se generaron con éxito los flujos para la entrada y salida de datos, arranca un Thread, que procesa los datos entrantes. Se inicia un Timer, que solicita datos conforme al comportamiento exigido de Polling. Aparece un error durante la conexión, se sale a través de un excepción.
if (arg0.getSource() == jbConnect) {
jbConnect.setEnabled(false);
jlStatusBar.setText("Trying to connect
to " + jtfIP.getText());
new Thread(this).start();
tiPoll = new Timer(Integer.parseInt(jtfInterval.getText()),
this);
tiPoll.start();
for (int i = 0; i < jpIO.getComponentCount();
i++) {
((JComponent) jpIO.getComponent(i)).setEnabled(true);
}
jbDisconnect.setEnabled(true);
jlStatusBar.setText("Connected
to " + jtfIP.getText());
jbConnect.setEnabled(true);
jlStatusBar.setText("Error - No Connection");
}
Conexión deseada: Pulsar la superficie de contacto "Disconnect" llama al método "disconnect". Este contiene instrucciones que desconectan controladamente la conexión y preparan al programa para la toma de una nueva conexión. Puesto que la conexión también puede introducirse a través de una excepción, la conexión se da en un método separado y no entro del método "actionPerformed".
else if (arg0.getSource() == jbDisconnect) {
disconnect();
}
Outputs schalten: Manipulando la cajas de chequeo "jcbOutput0" y "jcbOutput1" puede conectarse la salida respectiva. Si una de las cajas de chequeo activa un suceso, dependiendo del estado fijado se envía un String a través del zócalo al Web-IO, que pone en práctica la selección.
Leer Outputs e Inputs, leer y borrar contador: Las entradas y salidas pueden leerse completamente a través de una superficie de contacto. Para ello se envía una correspondiente cadena de comando al Web-IO. Se comporta igualmente con los contadores. En cada superficie de contacto se ha depositado una cadena de comando, que activa el resultado correspondiente.
Polling: El Timer, que se inició con la conexión, activa también cíclicamente un suceso. Según el estado de las tres cajas de chequeo de Polling, en cada ciclo se consultan las salidas, las entradas y los contadores.
else if (arg0.getSource() == tiPoll) {
if (jcbOutputPolling.isSelected()) {
write("GET /output?PW="
+ jtfPassword.getText() + "&");
}
if (jcbInputPolling.isSelected()) {
write("GET /input?PW="
+ jtfPassword.getText() + "&");
}
if (jcbCounterPolling.isSelected()) {
write("GET /counter?PW="
+ jtfPassword.getText() + "&");
}
}
8. Procesar cambios en los campos de texto
Cambio del intervalo de Polling: Cambios del intervalo de Polling se activan sin confirmación. Un cambio se reconoce mediante KeyListeners, que se añadió al campo de texto "tfInterval". Para ello la clase tiene que implementar los métodos de la interfaz ("keyPressed"," KeyReleased" und "keyTyped"). Al cambiar el contenido del campo de texto, en el método "keyPressed" el valor actualizado se convierte en un formato int y se entrega al Timer. Si no se puede convertir el contenido del campo de texto en una cifra, se sale a través de la excepción. En este caso no se cambia la cuota de Polling.
El método "run" se inicia al establecerse una conexión de zócalo y funciona como Thread "casi" paralelamente al propio programa. En el método el zócalo se controla permanentemente en un bucle while respecto a datos entrantes. Al interrumpirse la conexión se lee el valor -1, que es el criterio de interrupción del bucle. Al recibir un valor >0, éste se convierte en un signo según la tabla ASCII y se añade al string de recepción. Al recibir un 0 el string se ha recibido completamente y comienza el procesamiento. El comienzo de cada string ("output;", "input;", "counter;" y "counter") informa sobre la asignación de los datos. Después de la identificación de las informaciones se extraen éstas y se representan.
public void run() {
int iInput, iState;
String sIn = "";
StringTokenizer stToken;
try {
while
((iInput = isInStream.read()) != -1) {
if
(iInput > 0) {
sIn
+= (char) iInput;
}
else {
if
(sIn.startsWith("input")) {
iState
= Integer.parseInt(sIn.replaceFirst("input;", ""));
jcbInput0.setSelected(((iState
& 1) > 0) ? true : false);
jcbInput1.setSelected(((iState
& 2) > 0) ? true : false);
}
else if (sIn.startsWith("output")) {
iState
= Integer.parseInt(sIn.replaceFirst("output;",""));
jcbOutput0.setSelected(((iState
& 1) > 0) ? true : false);
jcbOutput1.setSelected(((iState
& 2) > 0) ? true : false);
}
else if (sIn.startsWith("counter")) {
if
(sIn.startsWith("counter;")) {
sIn
= sIn.replaceFirst("counter;", "");
stToken
= new StringTokenizer(sIn, ";");
jtfCounter0.setText(stToken.nextToken());
jtfCounter1.setText(stToken.nextToken());
}
else {
stToken
= new StringTokenizer(sIn, ";");
if
(stToken.nextToken().equals("counter0")) {
jtfCounter0.setText(stToken.nextToken());
}
else {
jtfCounter1.setText(stToken.nextToken());
}
sIn
= sIn.replaceFirst("counter", "");
}
}
sIn
= "";
}
}
disconnect();
} catch
(IOException e) {
}
}
10. Enviar strings de comando
Con el método "write" se escriben los strings de comando a transmitir al zócalo. La escritura se hace en dos pasos. La instrucción "write" entrega el string como cadena Byte al zócalo. La instrucción "flush" envía los Bytes al punto contrario. Si durante este proceso aparece un error, se interrumpe a través de la excepción.
Las instrucciones para una desconexión correcta están colocadas en un método separado, que se llama por un lado a través de una superficie de contacto "Disconnect" y por el otro con una interrupción de la conexión. Primero se desactiva la superficie de contacto "Disconnect", se emite la noticia a través de la conexión a la línea de estado y se para el timer de Polling. A continuación se cierra el zócalo. Si el proceso tiene éxito, todos los elementos de entrada y de indicación se colocan en el estado de partida. Si no funciona el cierre, la superficie se ajusta de nuevo para una conexión existente.
private void disconnect() {
jbDisconnect.setEnabled(false);
jlStatusBar.setText("Trying
to disconnect from " + jtfIP.getText());
try {
tiPoll.stop();
soClientSocket.close();
for
(int i = 0; i < jpIO.getComponentCount(); i++) {
((JComponent)
jpIO.getComponent(i)).setEnabled(false);
}
jbConnect.setEnabled(true);
jlStatusBar.setText("No
connection");
jbDisconnect.setEnabled(true);
jlStatusBar.setText("Error
- Connected to " + jtfIP.getText());
}
El programa ejemplo asiste todas las funciones corrientes del Web-IO en el modo String de comando, optimado para el Web-IO 2x Entradas digitales, 2x Salidas digitales. Para los otros modelos Web-IO tienen que realizarse adaptaciones en el programa. Otros ejemplos de programa para la programación del zócalo los encontrarán en las páginas de herramientas al Web-IO. Una descripción detallada de la interfaz del zócalo de los modelos Web-IO digitales la encontrarán en el manual de referencia.
