svn commit: r429988 - in /directory/trunks/mina/core/src/main/java/org/apache/mina/common: IoServiceConfig.java PooledThreadModel.java

[tr...@apache.org]

Author: trustin
Date: Wed Aug  9 01:13:39 2006
New Revision: 429988

URL: http://svn.apache.org/viewvc?rev=429988&view=rev
Log:
Added more documentation regarding PooledThreadModel and the default bahavior

Modified:
    directory/trunks/mina/core/src/main/java/org/apache/mina/common/IoServiceConfig.java
    directory/trunks/mina/core/src/main/java/org/apache/mina/common/PooledThreadModel.java

Modified: directory/trunks/mina/core/src/main/java/org/apache/mina/common/IoServiceConfig.java
URL: http://svn.apache.org/viewvc/directory/trunks/mina/core/src/main/java/org/apache/mina/common/IoServiceConfig.java?rev=429988&r1=429987&r2=429988&view=diff
==============================================================================
--- directory/trunks/mina/core/src/main/java/org/apache/mina/common/IoServiceConfig.java (original)
+++ directory/trunks/mina/core/src/main/java/org/apache/mina/common/IoServiceConfig.java Wed Aug  9 01:13:39 2006
@@ -62,14 +62,21 @@
     
     /**
      * Returns the default {@link ThreadModel} of the {@link IoService}.
-     * The default value is <tt>new {@link PooledThreadModel}()</tt>.
+     * The default value is a {@link PooledThreadModel}() whose service name is
+     * <tt>'AnonymousIoService'</tt> and which has 16 maximum active threads.
+     * It is strongly recommended to set a new {@link PooledThreadModel} by calling
+     * {@link PooledThreadModel#getInstance(String)}.
      */
     ThreadModel getThreadModel();
     
     /**
      * Sets the default {@link ThreadModel} of the {@link IoService}.
      * If you specify <tt>null</tt>, this property will be set to the
-     * default value.  The default value is <tt>new {@link PooledThreadModel}()</tt>.
+     * default value.
+     * The default value is a {@link PooledThreadModel}() whose service name is
+     * <tt>'AnonymousIoService'</tt> and which has 16 maximum active threads.
+     * It is strongly recommended to set a new {@link PooledThreadModel} by calling
+     * {@link PooledThreadModel#getInstance(String)}.
      */
     void setThreadModel( ThreadModel threadModel );
     

Modified: directory/trunks/mina/core/src/main/java/org/apache/mina/common/PooledThreadModel.java
URL: http://svn.apache.org/viewvc/directory/trunks/mina/core/src/main/java/org/apache/mina/common/PooledThreadModel.java?rev=429988&r1=429987&r2=429988&view=diff
==============================================================================
--- directory/trunks/mina/core/src/main/java/org/apache/mina/common/PooledThreadModel.java (original)
+++ directory/trunks/mina/core/src/main/java/org/apache/mina/common/PooledThreadModel.java Wed Aug  9 01:13:39 2006
@@ -57,6 +57,10 @@
     
     /**
      * Returns a {@link PooledThreadModel} instance for the specified <tt>serviceName</tt>.
+     * Please note that all returned instances will be managed globally; the same instance
+     * will be returned if you specified the same service name.  Please try to specify
+     * different names for different services.
+     * 
      * @param serviceName the name of the service that needs thread pooling
      */
     public static PooledThreadModel getInstance( String serviceName )