Dictionary.java

Go to the documentation of this file.

/*
 * Copyright 2012 Phidgets Inc.  All rights reserved.
 */

package com.phidgets;

import com.phidgets.event.*;

import java.util.Iterator;
import java.util.LinkedList;
import java.util.Vector;

public class Dictionary
{
        static
        {
                try
                {
                        System.loadLibrary("phidget21");
                }
                catch(UnsatisfiedLinkError ex)
                {
                        String os = System.getProperty("os.name");
                        if(os.startsWith("Linux"))
                        {
                                throw new ExceptionInInitializerError(ex.getMessage()
                                        +"\nCould not locate the Phidget C library (libphidget21.so)."
                                        +"\nMake sure it is installed, and add it's path to LD_LIBRARY_PATH.");
                        }
                        else if(os.startsWith("Windows"))
                        {
                                throw new ExceptionInInitializerError(ex.getMessage()
                                +"\nCould not locate the Phidget C library."
                                +"\nThe Windows Phidget21 MSI must be installed.");
                        }
                        else if(os.startsWith("Mac"))
                        {
                                throw new ExceptionInInitializerError(ex.getMessage()
                                +"\nCould not locate the Phidget C library."
                                +"\nThe Mac Phidget21 DMG must be installed.");
                        }
                        else
                        {
                                throw new ExceptionInInitializerError(ex.getMessage()
                                +"\nCould not locate the Phidget C library.");
                        }
                }
        }
        
        public long handle = 0;
        public Dictionary() throws PhidgetException
        {
                handle = create();
        }
        private final native long create() throws PhidgetException;

        private final native void nativeClose() throws PhidgetException;
        private final native void nativeDelete() throws PhidgetException;
        private final native void nativeOpenRemote(String serverID, String pass) throws PhidgetException;
        private final native void nativeOpenRemoteIP(String ipAddress, int port, String pass) throws PhidgetException;
        private final native void nativeAddKey(String key, String val, int persistent) throws PhidgetException;
        private final native void nativeRemoveKey(String keyPattern) throws PhidgetException;
        private final native String nativeGetKey(String key) throws PhidgetException;


        public final native String getServerAddress() throws PhidgetException;
        public final native String getServerID() throws PhidgetException;
        public final native int getServerPort() throws PhidgetException;
        public final native boolean isAttached() throws PhidgetException;

        public final native boolean isAttachedToServer() throws PhidgetException;

        public final void add(String key, String val) throws PhidgetException
        {
                nativeAddKey(key, val, 1);
        }

        public final void add(String key, String val, boolean persistent) throws PhidgetException
        {
                if (persistent) nativeAddKey(key, val, 1);
                else nativeAddKey(key, val, 0);
        }
        public final void remove(String pattern) throws PhidgetException
        {
                nativeRemoveKey(pattern);
        }

        public final String get(String key) throws PhidgetException
        {
                return nativeGetKey(key);
        }

        public final void open(String ipAddress, int port, String password) throws PhidgetException
        {
                enableEvents(true);
                nativeOpenRemoteIP(ipAddress, port, password);
        }
        public final void open(String ipAddress, int port) throws PhidgetException
        {
                enableEvents(true);
                nativeOpenRemoteIP(ipAddress, port, "");
        }
        public final void open(String serverID, String password) throws PhidgetException
        {
                enableEvents(true);
                nativeOpenRemote(serverID, password);
        }
        public final void open(String serverID) throws PhidgetException
        {
                enableEvents(true);
                nativeOpenRemote(serverID, "");
        }
        public final void close() throws PhidgetException
        {
                enableEvents(false);
                nativeClose();
        }

        private void enableEvents(boolean b)
        {
                enableServerConnectEvents(b && serverConnectListeners.size() > 0);
                enableServerDisconnectEvents(b && serverDisconnectListeners.size() > 0);
        }

        private LinkedList serverConnectListeners = new LinkedList();
        private long nativeServerConnectHandler = 0;

        public final void addServerConnectListener(ServerConnectListener l)
        {
                synchronized (serverConnectListeners)
                {
                        serverConnectListeners.add(l);
                        enableServerConnectEvents(true);
                }
        }

        public final void removeServerConnectListener(ServerConnectListener l)
        {
                synchronized (serverConnectListeners)
                {
                        serverConnectListeners.remove(l);
                        enableServerConnectEvents(serverConnectListeners.size() > 0);
                }
        }
        private void fireServerConnect(ServerConnectEvent e)
        {
                synchronized (serverConnectListeners)
                {
                        for (Iterator it = serverConnectListeners.iterator();
                          it.hasNext(); )
                                ((ServerConnectListener)it.next()).serverConnected(e);
                }
        }
        private native void enableServerConnectEvents(boolean b);


        private LinkedList serverDisconnectListeners = new LinkedList();
        private long nativeServerDisconnectHandler = 0;

        public final void addServerDisconnectListener(ServerDisconnectListener l)
        {
                synchronized (serverDisconnectListeners)
                {
                        serverDisconnectListeners.add(l);
                        enableServerDisconnectEvents(true);
                }
        }

        public final void removeServerDisconnectListener(ServerDisconnectListener l)
        {
                synchronized (serverDisconnectListeners)
                {
                        serverDisconnectListeners.remove(l);
                        enableServerDisconnectEvents(serverDisconnectListeners.size() > 0);
                }
        }
        private void fireServerDisconnect(ServerDisconnectEvent e)
        {
                synchronized (serverDisconnectListeners)
                {
                        for (Iterator it = serverDisconnectListeners.iterator();
                          it.hasNext(); )
                                ((ServerDisconnectListener)it.next()).serverDisconnected(e);
                }
        }
        private native void enableServerDisconnectEvents(boolean b);

        public String toString()
        {
                return "PhidgetDictionary: ";
        }

        protected void finalize() {
                try
                {
                        close();
                        nativeDelete();
                        handle = 0;
                } catch (Exception e) {
                        ;
                }
        }
}