From 64afb3e53f74b2ec78cacb377858cb092e3a4e9b Mon Sep 17 00:00:00 2001
From: neil_a_wilson <neil_a_wilson@localhost>
Date: Thu, 16 Aug 2007 00:36:48 +0000
Subject: [PATCH] Update package-info.java files to include the @PublicAPI annotation to indicate whether any or all of the classes in that package are intended to be part of the public API.  Further, mark all classes that we intend to be part of the public API with the @PublicAPI annotation to indicate the ways in which they may be used.  Note that the use of these annotations and the ultimate determination as to what is in our public API and the ways in which those elements may be used still needs to be carefully reviewed before the 1.0 release.

---
 opendj-sdk/opends/src/server/org/opends/server/api/ConnectionHandler.java |   19 ++++++++++++-------
 1 files changed, 12 insertions(+), 7 deletions(-)

diff --git a/opendj-sdk/opends/src/server/org/opends/server/api/ConnectionHandler.java b/opendj-sdk/opends/src/server/org/opends/server/api/ConnectionHandler.java
index f534f38..9ecf424 100644
--- a/opendj-sdk/opends/src/server/org/opends/server/api/ConnectionHandler.java
+++ b/opendj-sdk/opends/src/server/org/opends/server/api/ConnectionHandler.java
@@ -48,10 +48,15 @@
  *          The type of connection handler configuration handled by
  *          this connection handler implementation.
  */
+@org.opends.server.types.PublicAPI(
+     stability=org.opends.server.types.StabilityLevel.VOLATILE,
+     mayInstantiate=false,
+     mayExtend=true,
+     mayInvoke=false)
 public abstract class ConnectionHandler
-    <T extends ConnectionHandlerCfg>
-    extends DirectoryThread {
-
+       <T extends ConnectionHandlerCfg>
+       extends DirectoryThread
+{
   // The monitor associated with this connection handler.
   private ConnectionHandlerMonitor monitor;
 
@@ -81,7 +86,7 @@
    * that some connection handler implementations may not have any way
    * to continue processing requests from existing connections, in
    * which case they should always be closed regardless of the value
-   * of the <CODE>closeConnections</CODE> flag.
+   * of the {@code closeConnections} flag.
    *
    * @param finalizeReason
    *          The reason that this connection handler should be
@@ -212,7 +217,7 @@
    * @return  The monitor instance for this connection handler, or
    *          {@code null} if none has been provided.
    */
-  public ConnectionHandlerMonitor getConnectionHandlerMonitor()
+  public final ConnectionHandlerMonitor getConnectionHandlerMonitor()
   {
     return monitor;
   }
@@ -225,8 +230,8 @@
    * @param  monitor  The monitor instance for this connection
    *                  handler.
    */
-  public void setConnectionHandlerMonitor(
-                   ConnectionHandlerMonitor monitor)
+  public final void setConnectionHandlerMonitor(
+                         ConnectionHandlerMonitor monitor)
   {
     this.monitor = monitor;
   }

--
Gitblit v1.10.0