[jboss-svn-commits] JBoss Common SVN: r3912 - jboss-stdio/trunk/src/main/java/org/jboss/stdio.

[jboss-svn-commits at lists.jboss.org]

Author: david.lloyd at jboss.com
Date: 2010-01-07 15:04:34 -0500 (Thu, 07 Jan 2010)
New Revision: 3912

Modified:
   jboss-stdio/trunk/src/main/java/org/jboss/stdio/SimpleStdioContextSelector.java
   jboss-stdio/trunk/src/main/java/org/jboss/stdio/StdioContext.java
Log:
Javadoc, and MC convenience method

Modified: jboss-stdio/trunk/src/main/java/org/jboss/stdio/SimpleStdioContextSelector.java
===================================================================
--- jboss-stdio/trunk/src/main/java/org/jboss/stdio/SimpleStdioContextSelector.java	2010-01-07 19:57:58 UTC (rev 3911)
+++ jboss-stdio/trunk/src/main/java/org/jboss/stdio/SimpleStdioContextSelector.java	2010-01-07 20:04:34 UTC (rev 3912)
@@ -44,4 +44,13 @@
     public StdioContext getStdioContext() {
         return context;
     }
+
+    /**
+     * Attempt to install this context selector as the current one.
+     *
+     * @see StdioContext#setStdioContextSelector(StdioContextSelector)
+     */
+    public void install() {
+        StdioContext.setStdioContextSelector(this);
+    }
 }

Modified: jboss-stdio/trunk/src/main/java/org/jboss/stdio/StdioContext.java
===================================================================
--- jboss-stdio/trunk/src/main/java/org/jboss/stdio/StdioContext.java	2010-01-07 19:57:58 UTC (rev 3911)
+++ jboss-stdio/trunk/src/main/java/org/jboss/stdio/StdioContext.java	2010-01-07 20:04:34 UTC (rev 3912)
@@ -166,7 +166,14 @@
         state.set(State.UNINSTALLED);
     }
 
-    public static void setStdioContextSelector(final StdioContextSelector stdioContextSelector) {
+    /**
+     * Set the standard I/O context selector.  You must have the {@code setStdioContextSelector} {@link RuntimePermission} in
+     * order to invoke this method.
+     *
+     * @param stdioContextSelector the selector to use
+     * @throws SecurityException if the caller does not have the {@code installStdioContextSelector} {@link RuntimePermission}
+     */
+    public static void setStdioContextSelector(final StdioContextSelector stdioContextSelector) throws SecurityException {
         if (stdioContextSelector == null) {
             throw new NullPointerException("stdioContextSelector is null");
         }