Author: asmuts Date: Fri Oct 17 11:11:11 2008 New Revision: 705689 URL: http://svn.apache.org/viewvc?rev=705689&view=rev Log: doing some minor cleanup on some messy classes. more is needed
Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/LateralCacheAttributes.java jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/LateralCacheMonitor.java jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheFactory.java jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheManager.java jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPListener.java jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryManager.java jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryMessage.java jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryReceiver.java jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoverySender.java jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoverySenderThread.java jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryService.java jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/utils/SocketOpener.java Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/LateralCacheAttributes.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/LateralCacheAttributes.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/LateralCacheAttributes.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/LateralCacheAttributes.java Fri Oct 17 11:11:11 2008 @@ -26,9 +26,7 @@ import org.apache.jcs.auxiliary.lateral.behavior.ILateralCacheAttributes; /** - * This class stores attributes for all of the available lateral cache - * auxiliaries. - * + * This class stores attributes for all of the available lateral cache auxiliaries. */ public class LateralCacheAttributes extends AbstractAuxiliaryCacheAttributes @@ -37,16 +35,17 @@ /** Don't change */ private static final long serialVersionUID = -3408449508837393660L; + /** Default receive setting */ private static final boolean DEFAULT_RECEIVE = true; + /** THe type of lateral */ String transmissionTypeName = "UDP"; - + int transmissionType = UDP; String httpServers; - // used to identify the service that this manager will be - // operating on + /** used to identify the service that this manager will be operating on */ String httpServer = ""; String httpReceiveServlet = ""; @@ -59,23 +58,22 @@ int httpListenerPort = 8080; - - // JAVAGROUPS ------------------------- + /** REMOVE THIS: JAVAGROUPS ------------------------- */ private String jgChannelProperties = null; - // GENERAL ------------------------------ - // disables gets from laterals + /** disables gets from laterals */ boolean putOnlyMode = true; - // do we receive and broadcast or only broadcast - // this is useful when you don't want to get any notifications + /** + * do we receive and broadcast or only broadcast this is useful when you don't want to get any + * notifications + */ private boolean receive = DEFAULT_RECEIVE; /** * Sets the httpServer attribute of the LateralCacheAttributes object - * - * @param val - * The new httpServer value + * <P> + * @param val The new httpServer value */ public void setHttpServer( String val ) { @@ -84,7 +82,6 @@ /** * Gets the httpServer attribute of the LateralCacheAttributes object - * * @return The httpServer value */ public String getHttpServer() @@ -92,13 +89,9 @@ return httpServer; } - - /** * Sets the httpServers attribute of the LateralCacheAttributes object - * - * @param val - * The new httpServers value + * @param val The new httpServers value */ public void setHttpServers( String val ) { @@ -107,7 +100,6 @@ /** * Gets the httpSrvers attribute of the LateralCacheAttributes object - * * @return The httpServers value */ public String getHttpServers() @@ -115,13 +107,9 @@ return httpServers; } - - /** * Sets the httpListenerPort attribute of the ILateralCacheAttributes object - * - * @param val - * The new tcpListenerPort value + * @param val The new tcpListenerPort value */ public void setHttpListenerPort( int val ) { @@ -130,7 +118,6 @@ /** * Gets the httpListenerPort attribute of the ILateralCacheAttributes object - * * @return The httpListenerPort value */ public int getHttpListenerPort() @@ -140,9 +127,7 @@ /** * Sets the udpMulticastAddr attribute of the LateralCacheAttributes object - * - * @param val - * The new udpMulticastAddr value + * @param val The new udpMulticastAddr value */ public void setUdpMulticastAddr( String val ) { @@ -151,7 +136,6 @@ /** * Gets the udpMulticastAddr attribute of the LateralCacheAttributes object - * * @return The udpMulticastAddr value */ public String getUdpMulticastAddr() @@ -161,9 +145,7 @@ /** * Sets the udpMulticastPort attribute of the LateralCacheAttributes object - * - * @param val - * The new udpMulticastPort value + * @param val The new udpMulticastPort value */ public void setUdpMulticastPort( int val ) { @@ -172,7 +154,6 @@ /** * Gets the udpMulticastPort attribute of the LateralCacheAttributes object - * * @return The udpMulticastPort value */ public int getUdpMulticastPort() @@ -182,9 +163,7 @@ /** * Sets the transmissionType attribute of the LateralCacheAttributes object - * - * @param val - * The new transmissionType value + * @param val The new transmissionType value */ public void setTransmissionType( int val ) { @@ -213,7 +192,6 @@ /** * Gets the transmissionType attribute of the LateralCacheAttributes object - * * @return The transmissionType value */ public int getTransmissionType() @@ -222,11 +200,8 @@ } /** - * Sets the transmissionTypeName attribute of the LateralCacheAttributes - * object - * - * @param val - * The new transmissionTypeName value + * Sets the transmissionTypeName attribute of the LateralCacheAttributes object + * @param val The new transmissionTypeName value */ public void setTransmissionTypeName( String val ) { @@ -255,9 +230,7 @@ } /** - * Gets the transmissionTypeName attribute of the LateralCacheAttributes - * object - * + * Gets the transmissionTypeName attribute of the LateralCacheAttributes object * @return The transmissionTypeName value */ public String getTransmissionTypeName() @@ -266,12 +239,10 @@ } /** - * Sets the outgoingOnlyMode attribute of the ILateralCacheAttributes. When - * this is true the lateral cache will only issue put and remove order and - * will not try to retrieve elements from other lateral caches. - * - * @param val - * The new transmissionTypeName value + * Sets the outgoingOnlyMode attribute of the ILateralCacheAttributes. When this is true the + * lateral cache will only issue put and remove order and will not try to retrieve elements from + * other lateral caches. + * @param val The new transmissionTypeName value */ public void setPutOnlyMode( boolean val ) { @@ -298,7 +269,6 @@ /** * Returns a clone of the attributes. - * * @return Self */ public AuxiliaryCacheAttributes copy() @@ -314,11 +284,8 @@ return this; } - - /** - * @param receive - * The receive to set. + * @param receive The receive to set. */ public void setReceive( boolean receive ) { @@ -333,8 +300,6 @@ return receive; } - - /* * (non-Javadoc) * Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/LateralCacheMonitor.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/LateralCacheMonitor.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/LateralCacheMonitor.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/LateralCacheMonitor.java Fri Oct 17 11:11:11 2008 @@ -27,39 +27,39 @@ import org.apache.jcs.engine.CacheConstants; /** - * Used to monitor and repair any failed connection for the lateral cache - * service. By default the monitor operates in a failure driven mode. That is, - * it goes into a wait state until there is an error. Upon the notification of a - * connection error, the monitor changes to operate in a time driven mode. That - * is, it attempts to recover the connections on a periodic basis. When all - * failed connections are restored, it changes back to the failure driven mode. - * + * Used to monitor and repair any failed connection for the lateral cache service. By default the + * monitor operates in a failure driven mode. That is, it goes into a wait state until there is an + * error. Upon the notification of a connection error, the monitor changes to operate in a time + * driven mode. That is, it attempts to recover the connections on a periodic basis. When all failed + * connections are restored, it changes back to the failure driven mode. */ public class LateralCacheMonitor implements Runnable { + /** The logger */ private final static Log log = LogFactory.getLog( LateralCacheMonitor.class ); + /** How long to wait between runs */ private static long idlePeriod = 20 * 1000; - // minimum 20 seconds. - //private static long idlePeriod = 3*1000; // for debugging. - - // Must make sure LateralCacheMonitor is started before any lateral error - // can be detected! + /** + * Must make sure LateralCacheMonitor is started before any lateral error can be detected! + */ private boolean alright = true; + /** code for eror */ private final static int ERROR = 1; + /** The mode we are running in. Error driven */ private static int mode = ERROR; + /** The manager */ private ILateralCacheManager manager; /** * Configures the idle period between repairs. - * - * @param idlePeriod - * The new idlePeriod value + * <p> + * @param idlePeriod The new idlePeriod value */ public static void setIdlePeriod( long idlePeriod ) { @@ -70,9 +70,8 @@ } /** - * Allows close classes, ie testers to set the idle period to something - * testable. - * + * Allows close classes, ie testers to set the idle period to something testable. + * <p> * @param idlePeriod */ protected static void forceShortIdlePeriod( long idlePeriod ) @@ -80,11 +79,11 @@ LateralCacheMonitor.idlePeriod = idlePeriod; } - /** Constructor for the LateralCacheMonitor object + /** + * Constructor for the LateralCacheMonitor object + * <p> + * It's the clients responsibility to decide how many of these there will be. * <p> - * It's the clients responsibility to decide how many - * of these there will be. - * * @param manager */ public LateralCacheMonitor( ILateralCacheManager manager ) @@ -93,8 +92,7 @@ } /** - * Notifies the cache monitor that an error occurred, and kicks off the - * error recovery process. + * Notifies the cache monitor that an error occurred, and kicks off the error recovery process. */ public void notifyError() { Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheFactory.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheFactory.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheFactory.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheFactory.java Fri Oct 17 11:11:11 2008 @@ -154,6 +154,8 @@ * @param lac ITCPLateralCacheAttributes * @param lcnwf * @param cacheMgr + * @param cacheEventLogger + * @param elementSerializer * @return null if none is created. */ private UDPDiscoveryService createDiscoveryService( ITCPLateralCacheAttributes lac, LateralCacheNoWaitFacade lcnwf, Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheManager.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheManager.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheManager.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPCacheManager.java Fri Oct 17 11:11:11 2008 @@ -56,10 +56,13 @@ public class LateralTCPCacheManager extends LateralCacheAbstractManager { + /** Don't change. */ private static final long serialVersionUID = -9213011856644392480L; + /** The logger. */ private final static Log log = LogFactory.getLog( LateralTCPCacheManager.class ); + /** The monitor */ private static LateralCacheMonitor monitor; /** Address to instance map. */ @@ -68,6 +71,7 @@ /** ITCPLateralCacheAttributes */ protected ITCPLateralCacheAttributes lca; + /** number of clients, we can remove this. */ private int clients; /** Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPListener.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPListener.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPListener.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/LateralTCPListener.java Fri Oct 17 11:11:11 2008 @@ -43,19 +43,20 @@ import EDU.oswego.cs.dl.util.concurrent.ThreadFactory; /** - * Listens for connections from other TCP lateral caches and handles them. The - * initialization method starts a listening thread, which creates a socket - * server. When messages are received they are passed to a pooled executor which - * then calls the appropriate handle method. + * Listens for connections from other TCP lateral caches and handles them. The initialization method + * starts a listening thread, which creates a socket server. When messages are received they are + * passed to a pooled executor which then calls the appropriate handle method. */ public class LateralTCPListener implements ILateralCacheListener, Serializable { + /** Don't change. */ private static final long serialVersionUID = -9107062664967131738L; + /** The logger */ private final static Log log = LogFactory.getLog( LateralTCPListener.class ); - /** How long the server will block on an accept(). 0 is infinte. */ + /** How long the server will block on an accept(). 0 is infinite. */ private final static int acceptTimeOut = 0; /** The CacheHub this listener is associated with */ @@ -67,34 +68,39 @@ /** The socket listener */ private ListenerThread receiver; + /** Configuration attributes */ private ITCPLateralCacheAttributes tcpLateralCacheAttributes; + /** Listening port */ private int port; + /** The processor. We should probably use an event queue here. */ private PooledExecutor pooledExecutor; + /** put count */ private int putCnt = 0; + /** remove count */ private int removeCnt = 0; + /** get count */ private int getCnt = 0; /** - * Use the vmid by default. This can be set for testing. If we ever need to - * run more than one per vm, then we need a new technique. + * Use the vmid by default. This can be set for testing. If we ever need to run more than one + * per vm, then we need a new technique. */ private long listenerId = LateralCacheInfo.listenerId; /** * Gets the instance attribute of the LateralCacheTCPListener class. * <p> - * @param ilca - * ITCPLateralCacheAttributes + * @param ilca ITCPLateralCacheAttributes * @param cacheMgr * @return The instance value */ public synchronized static ILateralCacheListener getInstance( ITCPLateralCacheAttributes ilca, - ICompositeCacheManager cacheMgr ) + ICompositeCacheManager cacheMgr ) { ILateralCacheListener ins = (ILateralCacheListener) instances.get( String.valueOf( ilca.getTcpListenerPort() ) ); @@ -118,8 +124,7 @@ } /** - * Only need one since it does work for all regions, just reference by - * multiple region names. + * Only need one since it does work for all regions, just reference by multiple region names. * <p> * @param ilca */ @@ -153,21 +158,18 @@ } /** - * Let the lateral cache set a listener_id. Since there is only one - * listerenr for all the regions and every region gets registered? the id - * shouldn't be set if it isn't zero. If it is we assume that it is a - * reconnect. + * Let the lateral cache set a listener_id. Since there is only one listerenr for all the + * regions and every region gets registered? the id shouldn't be set if it isn't zero. If it is + * we assume that it is a reconnect. * <p> * By default, the listener id is the vmid. * <p> - * The service should set this value. This value will never be changed by a - * server we connect to. It needs to be non static, for unit tests. + * The service should set this value. This value will never be changed by a server we connect + * to. It needs to be non static, for unit tests. * <p> - * The service will use the value it sets in all send requests to the - * sender. + * The service will use the value it sets in all send requests to the sender. * <p> - * @param id - * The new listenerId value + * @param id The new listenerId value * @throws IOException */ public void setListenerId( long id ) @@ -193,8 +195,8 @@ } /** - * Increments the put count. Gets the cache that was injected by the lateral - * factory. Calls put on the cache. + * Increments the put count. Gets the cache that was injected by the lateral factory. Calls put + * on the cache. * <p> * @see org.apache.jcs.engine.behavior.ICacheListener#handlePut(org.apache.jcs.engine.behavior.ICacheElement) */ @@ -220,8 +222,8 @@ } /** - * Increments the remove count. Gets the cache that was injected by the - * lateral factory. Calls remove on the cache. + * Increments the remove count. Gets the cache that was injected by the lateral factory. Calls + * remove on the cache. * <p> * @see org.apache.jcs.engine.behavior.ICacheListener#handleRemove(java.lang.String, * java.io.Serializable) @@ -247,8 +249,7 @@ } /** - * Gets the cache that was injected by the lateral factory. Calls removeAll - * on the cache. + * Gets the cache that was injected by the lateral factory. Calls removeAll on the cache. * <p> * @see org.apache.jcs.engine.behavior.ICacheListener#handleRemoveAll(java.lang.String) */ @@ -264,8 +265,7 @@ } /** - * Gets the cache that was injected by the lateral factory. Calls get on the - * cache. + * Gets the cache that was injected by the lateral factory. Calls get on the cache. * <p> * @param cacheName * @param key @@ -314,8 +314,8 @@ /** * Gets the cacheManager attribute of the LateralCacheTCPListener object. * <p> - * Normally this is set by the factory. If it wasn't set the listener - * defaults to the expected singleton behavior of the cache amanger. + * Normally this is set by the factory. If it wasn't set the listener defaults to the expected + * singleton behavior of the cache amanger. * <p> * @param name * @return CompositeCache @@ -363,8 +363,7 @@ } /** - * @param cacheMgr - * The cacheMgr to set. + * @param cacheMgr The cacheMgr to set. */ public void setCacheManager( ICompositeCacheManager cacheMgr ) { @@ -380,8 +379,7 @@ } /** - * @param tcpLateralCacheAttributes - * The tcpLateralCacheAttributes to set. + * @param tcpLateralCacheAttributes The tcpLateralCacheAttributes to set. */ public void setTcpLateralCacheAttributes( ITCPLateralCacheAttributes tcpLateralCacheAttributes ) { @@ -397,8 +395,8 @@ } /** - * Processes commands from the server socket. There should be one listener - * for each configured TCP lateral. + * Processes commands from the server socket. There should be one listener for each configured + * TCP lateral. */ public class ListenerThread extends Thread @@ -444,12 +442,12 @@ } /** - * A Separate thread taht runs when a command comes into the - * LateralTCPReceiver. + * A Separate thread taht runs when a command comes into the LateralTCPReceiver. */ public class ConnectionHandler implements Runnable { + /** The socket connection, passed in via constructor */ private Socket socket; /** @@ -532,8 +530,8 @@ } /** - * This calls the appropriate method, based on the command sent in the - * Lateral element descriptor. + * This calls the appropriate method, based on the command sent in the Lateral element + * descriptor. * <p> * @param led * @throws IOException @@ -604,14 +602,14 @@ /** * Allows us to set the daemon status on the executor threads * <p> - * @author aaronsm + * @author Aaron Smuts */ class MyThreadFactory implements ThreadFactory { - /* - * (non-Javadoc) - * @see EDU.oswego.cs.dl.util.concurrent.ThreadFactory#newThread(java.lang.Runnable) + /** + * @param runner + * @return daemon thread */ public Thread newThread( Runnable runner ) { Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/TCPLateralCacheAttributes.java Fri Oct 17 11:11:11 2008 @@ -35,18 +35,25 @@ /** Don't change. */ private static final long serialVersionUID = 1077889204513905220L; + /** default */ private static final String DEFAULT_UDP_DISCOVERY_ADDRESS = "228.5.6.7"; + /** default */ private static final int DEFAULT_UDP_DISCOVERY_PORT = 6789; + /** default */ private static final boolean DEFAULT_UDP_DISCOVERY_ENABLED = true; + /** default */ private static final boolean DEFAULT_ALLOW_GET = true; + /** default */ private static final boolean DEFAULT_ALLOW_PUT = true; + /** default */ private static final boolean DEFAULT_ISSUE_REMOVE_FOR_PUT = false; + /** default */ private static final boolean DEFAULT_FILTER_REMOVE_BY_HASH_CODE = true; // TCP -------------------------------------------- Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryManager.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryManager.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryManager.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryManager.java Fri Oct 17 11:11:11 2008 @@ -30,22 +30,23 @@ import org.apache.jcs.engine.logging.behavior.ICacheEventLogger; /** - * This manages UDPDiscovery Services. We should end up with one service per - * Lateral Cache Manager Instance. One service works for multiple regions. We - * don't want a connection for each region. + * This manages UDPDiscovery Services. We should end up with one service per Lateral Cache Manager + * Instance. One service works for multiple regions. We don't want a connection for each region. * <p> * @author Aaron Smuts - * */ public class UDPDiscoveryManager { + /** The logger */ private final static Log log = LogFactory.getLog( UDPDiscoveryManager.class ); + /** Singleton instance */ private static UDPDiscoveryManager INSTANCE = new UDPDiscoveryManager(); + /** Known services */ private Map services = new HashMap(); - + /** private for singleton */ private UDPDiscoveryManager() { // noopt @@ -53,7 +54,7 @@ /** * Singelton - * + * <p> * @return UDPDiscoveryManager */ public static UDPDiscoveryManager getInstance() @@ -63,18 +64,20 @@ /** * Returns the UDP Discovery service associated with this instance. - * - * @param lca - * ITCPLateralCacheAttributes + * <p> + * @param lca ITCPLateralCacheAttributes * @param cacheMgr - * @param cacheEventLogger - * @param elementSerializer + * @param cacheEventLogger + * @param elementSerializer * @return instance for this address */ - public synchronized UDPDiscoveryService getService( ITCPLateralCacheAttributes lca, ICompositeCacheManager cacheMgr, ICacheEventLogger cacheEventLogger, + public synchronized UDPDiscoveryService getService( ITCPLateralCacheAttributes lca, + ICompositeCacheManager cacheMgr, + ICacheEventLogger cacheEventLogger, IElementSerializer elementSerializer ) { - UDPDiscoveryService service = getService( lca.getUdpDiscoveryAddr(), lca.getUdpDiscoveryPort(), lca.getTcpListenerPort(), cacheMgr, cacheEventLogger, elementSerializer ); + UDPDiscoveryService service = getService( lca.getUdpDiscoveryAddr(), lca.getUdpDiscoveryPort(), lca + .getTcpListenerPort(), cacheMgr, cacheEventLogger, elementSerializer ); // TODO find a way to remote these attributes from the service, the manager needs it on disocvery. service.setTcpLateralCacheAttributes( lca ); @@ -85,18 +88,19 @@ * Creates a service for the address and port if one doesn't exist already. * <p> * TODO we may need to key this using the listener port too - * + * <p> * @param discoveryAddress * @param discoveryPort * @param servicePort * @param cacheMgr - * @param cacheEventLogger - * @param elementSerializer * + * @param cacheEventLogger + * @param elementSerializer * @return UDPDiscoveryService */ private synchronized UDPDiscoveryService getService( String discoveryAddress, int discoveryPort, int servicePort, - ICompositeCacheManager cacheMgr, ICacheEventLogger cacheEventLogger, - IElementSerializer elementSerializer ) + ICompositeCacheManager cacheMgr, + ICacheEventLogger cacheEventLogger, + IElementSerializer elementSerializer ) { String key = discoveryAddress + ":" + discoveryPort; @@ -108,7 +112,8 @@ log.info( "Creating service for address:port [" + key + "]" ); } - service = new UDPDiscoveryService( discoveryAddress, discoveryPort, servicePort, cacheMgr, cacheEventLogger, elementSerializer ); + service = new UDPDiscoveryService( discoveryAddress, discoveryPort, servicePort, cacheMgr, + cacheEventLogger, elementSerializer ); services.put( key, service ); } @@ -118,7 +123,5 @@ } return service; - } - } Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryMessage.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryMessage.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryMessage.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryMessage.java Fri Oct 17 11:11:11 2008 @@ -43,15 +43,19 @@ */ public static final int REQUEST_BROADCAST = 1; + /** The message type */ private int messageType = PASSIVE_BROADCAST; + /** udp port */ private int port = 6789; + /** UDP host */ private String host = "228.5.6.7"; - /** Description of the Field */ + /** Id of the requestor, allows self-filtration */ private long requesterId; + /** Names of regions */ private ArrayList cacheNames = new ArrayList(); /** Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryReceiver.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryReceiver.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryReceiver.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryReceiver.java Fri Oct 17 11:11:11 2008 @@ -59,27 +59,31 @@ /** The socket used for communication. */ private MulticastSocket m_socket; - // todo consider using the threadpool manager to - // get this thread pool - // for now place a tight restrcition on the pool size + /** + * TODO: Consider using the threadpool manager to get this thread pool. For now place a tight + * restriction on the pool size + */ private static final int maxPoolSize = 10; + /** The processor */ private PooledExecutor pooledExecutor = null; - // number of messages received. + /** number of messages received. For debugging and testing. */ private int cnt = 0; - /** - * Service to get cache names and hande request broadcasts - */ + /** Service to get cache names and hande request broadcasts */ protected UDPDiscoveryService service = null; + /** Address */ private String multicastAddressString = ""; + /** The port */ private int multicastPort = 0; + /** The cache manager. */ private ICompositeCacheManager cacheMgr; + /** Is it shutdown. */ private boolean shutdown = false; /** The event logger. */ @@ -271,6 +275,7 @@ public class MessageHandler implements Runnable { + /** The message to handle. Passed in during construction. */ private UDPDiscoveryMessage message = null; /** @@ -397,7 +402,7 @@ { Thread t = new Thread( runner ); String oldName = t.getName(); - t.setName( "JCS-UDPDiscoveryReceiver-" + oldName ); + t.setName( "JCS-UDPDiscoveryReceiver-" + oldName ); t.setDaemon( true ); t.setPriority( Thread.MIN_PRIORITY ); return t; Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoverySender.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoverySender.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoverySender.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoverySender.java Fri Oct 17 11:11:11 2008 @@ -33,18 +33,21 @@ /** * This is a generic sender for the UDPDiscovery process. - * + * <p> * @author Aaron Smuts - * */ public class UDPDiscoverySender { + /** The logger. */ private final static Log log = LogFactory.getLog( UDPDiscoverySender.class ); + /** The socket */ private MulticastSocket m_localSocket; + /** The address */ private InetAddress m_multicastAddress; + /** The port */ private int m_multicastPort; /** @@ -53,10 +56,8 @@ * This sender can be used to send multiple messages. * <p> * When you are done sending, you should destroy the socket sender. - * * @param host * @param port - * * @exception IOException */ public UDPDiscoverySender( String host, int port ) @@ -81,7 +82,6 @@ /** * Closes the socket connection. - * */ public void destroy() { @@ -102,7 +102,6 @@ /** * Just being careful about closing the socket. - * * @throws Throwable */ public void finalize() @@ -114,7 +113,6 @@ /** * Send messages. - * * @param message * @throws IOException */ @@ -159,10 +157,8 @@ } /** - * Ask other to broadcast their info the the multicast address. If a lateral - * is non receiving it can use this. This is also called on startup so we - * can get info. - * + * Ask other to broadcast their info the the multicast address. If a lateral is non receiving it + * can use this. This is also called on startup so we can get info. * @throws IOException */ public void requestBroadcast() @@ -180,11 +176,9 @@ } /** - * This sends a message braodcasting our that the host and port is available - * for connections. + * This sends a message braodcasting our that the host and port is available for connections. * <p> * It uses the vmid as the requesterDI - * * @param host * @param port * @param cacheNames @@ -198,7 +192,6 @@ /** * This allows you to set the sender id. This is mainly for testing. - * * @param host * @param port * @param cacheNames @@ -225,7 +218,6 @@ /** * This allows us to get the byte array from an output stream. - * * @author asmuts * @created January 15, 2002 */ @@ -235,7 +227,6 @@ { /** * Gets the bytes attribute of the MyByteArrayOutputStream object - * * @return The bytes value */ public byte[] getBytes() Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoverySenderThread.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoverySenderThread.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoverySenderThread.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoverySenderThread.java Fri Oct 17 11:11:11 2008 @@ -42,8 +42,10 @@ /** the host and port we listen on for TCP socket connections */ private String myHostName = null; + /** The udp port */ private int myPort = 0; + /** List of known regions. */ private ArrayList cacheNames = new ArrayList(); /** Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryService.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryService.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryService.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/discovery/UDPDiscoveryService.java Fri Oct 17 11:11:11 2008 @@ -61,24 +61,31 @@ /** thread that listens for messages */ private Thread udpReceiverThread; - // the runanble that the receiver thread runs + /** the runanble that the receiver thread runs */ private UDPDiscoveryReceiver receiver; + /** Map of facades */ private Map facades = new HashMap(); - // the runanble that sends messages via the clock daemon + /** the runnanble that sends messages via the clock daemon */ private UDPDiscoverySenderThread sender = null; + /** The host address */ private String hostAddress = "unknown"; + /** THe udp address */ private String discoveryAddress; + /** The port to braodcast to. */ private int discoveryPort; - // the port this service runs on, the service we are telling other about - // we should have a service info object instead + /** + * the port this service runs on, the service we are telling other about. we should have a + * service info object instead + */ private int servicePort; + /** Attributes for creating new instances. */ private ITCPLateralCacheAttributes tcpLateralCacheAttributes; /** The event logger. */ @@ -257,7 +264,8 @@ /** * Get all the cache names we have facades for. - * @return + * <p> + * @return ArrayList */ protected ArrayList getCacheNames() { @@ -290,7 +298,7 @@ { Thread t = new Thread( runner ); String oldName = t.getName(); - t.setName( "JCS-UDPDiscoveryService-" + oldName ); + t.setName( "JCS-UDPDiscoveryService-" + oldName ); t.setDaemon( true ); t.setPriority( Thread.MIN_PRIORITY ); return t; Modified: jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/utils/SocketOpener.java URL: http://svn.apache.org/viewvc/jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/utils/SocketOpener.java?rev=705689&r1=705688&r2=705689&view=diff ============================================================================== --- jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/utils/SocketOpener.java (original) +++ jakarta/jcs/trunk/src/java/org/apache/jcs/auxiliary/lateral/socket/tcp/utils/SocketOpener.java Fri Oct 17 11:11:11 2008 @@ -23,24 +23,26 @@ import java.net.Socket; /** - * Socket openere that will timeout on the initial connect rather than block + * This should no longer be needed. + * <p> + * Socket opener that will timeout on the initial connect rather than block * forever. Technique from core java II. - * - * @version $Id$ */ public class SocketOpener implements Runnable { - + /** The host */ private String host; + /** The port. */ private int port; + /** The socket */ private Socket socket; /** - * Opens a socket with a connection timeout value. Joins against a backgroud - * thread that does the openeing. + * Opens a socket with a connection timeout value. Joins against a background + * thread that does the opening. * * @param host * @param port --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]