depreciated old

Author: Katsute

src/main/java/com/kttdevelopment/simplehttpserver/SimpleHttpServer.java

@@ -299,10 +299,14 @@ public static SimpleHttpServer create(final int port, final int backlog) throws
 
 //
 
+    // region depreciated - temporary context
+
     /**
      * Creates a temporary context at a random address that will remove itself after the first connection. This type of context is typically used for single use downloads or media file hosting. <br>
      * To get the context use {@link HttpContext#getPath()}.
      *
+     * @deprecated Use {@link com.kttdevelopment.simplehttpserver.handler.TemporaryHandler} instead
+     *
      * @return the http context associated with the context
      *
      * @see HttpContext
@@ -318,12 +322,15 @@ public static SimpleHttpServer create(final int port, final int backlog) throws
      * @since 02.00.00
      * @author Ktt Development
      */
+    @Deprecated
     public abstract HttpContext createTemporaryContext();
 
     /**
      * Creates a temporary context at a random address that will remove itself after the first connection or after the max time is passed. This type of context is typically used for single use downloads or media file hosting. <br>
      * To get the context use {@link HttpContext#getPath()}.
      *
+     * @deprecated Use {@link com.kttdevelopment.simplehttpserver.handler.TemporaryHandler} instead
+     *
      * @param maxTime the maximum time the context may exist for (in milliseconds)
      * @return the http context associated with the context
      *
@@ -340,13 +347,16 @@ public static SimpleHttpServer create(final int port, final int backlog) throws
      * @since 02.00.00
      * @author Ktt Development
      */
+    @Deprecated
     public abstract HttpContext createTemporaryContext(final long maxTime);
 
     /**
      * Creates a temporary context at a random address that will remove itself after the first connection. This type of context is typically used for single use downloads or media file hosting. <br>
      * To get the context use {@link HttpContext#getPath()}. <br>
      * This method encapsulates the handler with a temporary one, so {@link HttpContext#getHandler()} will not return the one passed in the parameter, instead it will return the encapsulating handler.
      *
+     * @deprecated Use {@link com.kttdevelopment.simplehttpserver.handler.TemporaryHandler} instead
+     *
      * @param handler handler to use
      * @return the http context associated with the context
      *
@@ -364,13 +374,16 @@ public static SimpleHttpServer create(final int port, final int backlog) throws
      * @since 02.00.00
      * @author Ktt Development
      */
+    @Deprecated
     public abstract HttpContext createTemporaryContext(final HttpHandler handler);
 
     /**
      * Creates a temporary context at a random address that will remove itself after the first connection or after the max time is passed. This type of context is typically used for single use downloads or media file hosting. <br>
      * To get the context use {@link HttpContext#getPath()}. <br>
      * This method encapsulates the handler with a temporary one, so {@link HttpContext#getHandler()} will not return the one passed in the parameter, instead it will return the encapsulating handler.
      *
+     * @deprecated Use {@link com.kttdevelopment.simplehttpserver.handler.TemporaryHandler} instead
+     *
      * @param handler handler to use
      * @param maxTime the maximum time the context may exist for (in milliseconds)
      * @return the http context associated with the context
@@ -389,11 +402,14 @@ public static SimpleHttpServer create(final int port, final int backlog) throws
      * @since 02.00.00
      * @author Ktt Development
      */
+    @Deprecated
     public abstract HttpContext createTemporaryContext(final HttpHandler handler, final long maxTime);
 
     /**
      * Creates a temporary context at a specified address that will remove itself after the first connection. This type of context is typically used for single use downloads or media file hosting. <br>
      *
+     * @deprecated Use {@link com.kttdevelopment.simplehttpserver.handler.TemporaryHandler} instead
+     *
      * @param context the context
      * @return the http context associated with the context
      * @throws IllegalArgumentException if the context is invalid or taken
@@ -412,11 +428,14 @@ public static SimpleHttpServer create(final int port, final int backlog) throws
      * @since 02.00.00
      * @author Ktt Development
      */
+    @Deprecated
     public abstract HttpContext createTemporaryContext(final String context);
 
     /**
      * Creates a temporary context at a specified address that will remove itself after the first connection or after the max time is passed. This type of context is typically used for single use downloads or media file hosting. <br>
      *
+     * @deprecated Use {@link com.kttdevelopment.simplehttpserver.handler.TemporaryHandler} instead
+     *
      * @param context the context
      * @param maxTime the maximum time the context may exist for (in milliseconds)
      * @return the http context associated with the context
@@ -437,12 +456,15 @@ public static SimpleHttpServer create(final int port, final int backlog) throws
      * @since 02.00.00
      * @author Ktt Development
      */
+    @Deprecated
     public abstract HttpContext createTemporaryContext(final String context, final long maxTime);
 
     /**
      * Creates a temporary context at a specified address that will remove itself after the first connection. This type of context is typically used for single use downloads or media file hosting. <br>
      * This method encapsulates the handler with a temporary one, so {@link HttpContext#getHandler()} will not return the one passed in the parameter, instead it will return the encapsulating handler.
      *
+     * @deprecated Use {@link com.kttdevelopment.simplehttpserver.handler.TemporaryHandler} instead
+     *
      * @param context the context
      * @param handler handler to use
      * @return the http context associated with the context
@@ -463,6 +485,7 @@ public static SimpleHttpServer create(final int port, final int backlog) throws
      * @since 02.00.00
      * @author Ktt Development
      */
+    @Deprecated
     public abstract HttpContext createTemporaryContext(final String context, final HttpHandler handler);
 
 
@@ -471,6 +494,8 @@ public static SimpleHttpServer create(final int port, final int backlog) throws
      * To get the context use {@link HttpContext#getPath()}. <br>
      * This method encapsulates the handler with a temporary one, so {@link HttpContext#getHandler()} will not return the one passed in the parameter, instead it will return the encapsulating handler.
      *
+     * @deprecated Use {@link com.kttdevelopment.simplehttpserver.handler.TemporaryHandler} instead
+     *
      * @param context the context
      * @param handler handler to use
      * @param maxTime the maximum time the context may exist for (in milliseconds)
@@ -492,8 +517,11 @@ public static SimpleHttpServer create(final int port, final int backlog) throws
      * @since 02.00.00
      * @author Ktt Development
      */
+    @Deprecated
     public abstract HttpContext createTemporaryContext(final String context, final HttpHandler handler, final long maxTime);
 
+    // endregion
+
 //
 
     /**
@@ -549,11 +577,39 @@ public static SimpleHttpServer create(final int port, final int backlog) throws
      * Returns a copy of the server's contexts and their respective handlers.
      *
      * @return server's contexts
+     *
      * @since 02.00.00
      * @author Ktt Development
      */
     public abstract Map<HttpContext,HttpHandler> getContexts();
 
+    //
+
+    /**
+     * Generates a random context at the root that can be used on the server.
+     *
+     * @return random safe context
+     *
+     * @see #getRandomContext(String)
+     * @see com.kttdevelopment.simplehttpserver.handler.TemporaryHandler
+     * @since 03.03.00
+     * @author Ktt Development
+     */
+    public abstract String getRandomContext();
+
+    /**
+     * Generates a randome context that can be used on the server.
+     *
+     * @param context where to generate the random context
+     * @return randome safe context
+     *
+     * @see #getRandomContext()
+     * @see com.kttdevelopment.simplehttpserver.handler.TemporaryHandler
+     * @since 03.03.00
+     * @author Ktt Development
+     */
+    public abstract String getRandomContext(final String context);
+
 //
 
     /**

src/main/java/com/kttdevelopment/simplehttpserver/SimpleHttpServerImpl.java

@@ -161,6 +161,7 @@ public synchronized final HttpContext createContext(final String path, final Htt
 
             //
 
+            @Deprecated
             private String generateRandomContext(){
                 String targetContext;
 
@@ -172,32 +173,34 @@ private String generateRandomContext(){
 
             //
 
-            @Override
+            // region depreciated - temporary context
+
+            @Override @Deprecated
             public synchronized final HttpContext createTemporaryContext(){
                 return createTemporaryContext(generateRandomContext());
             }
 
-            @Override
+            @Override @Deprecated
             public synchronized final HttpContext createTemporaryContext(final long maxTime){
                 return createTemporaryContext(generateRandomContext(),maxTime);
             }
 
-            @Override
+            @Override @Deprecated
             public synchronized final HttpContext createTemporaryContext(final HttpHandler handler){
                 return createTemporaryContext(generateRandomContext(),handler);
             }
 
-            @Override
+            @Override @Deprecated
             public synchronized final HttpContext createTemporaryContext(final HttpHandler handler, final long maxTime){
                 return createTemporaryContext(generateRandomContext(),handler,maxTime);
             }
 
-            @Override
+            @Override @Deprecated
             public synchronized final HttpContext createTemporaryContext(final String context){
                 return createContext(context, (HttpExchange exchange) -> removeContext(context));
             }
 
-            @Override
+            @Override @Deprecated
             public synchronized final HttpContext createTemporaryContext(final String context, final long maxTime){
                 final HttpContext httpContext = createContext(context, (HttpExchange exchange) -> removeContext(context));
 
@@ -211,15 +214,15 @@ public synchronized final HttpContext createTemporaryContext(final String contex
                 return httpContext;
             }
 
-            @Override
+            @Override @Deprecated
             public synchronized final HttpContext createTemporaryContext(final String context, final HttpHandler handler){
                 return createContext(context, (HttpExchange exchange) -> {
                     handler.handle(exchange);
                     removeContext(context);
                 });
             }
 
-            @Override
+            @Override @Deprecated
             public synchronized final HttpContext createTemporaryContext(final String context, final HttpHandler handler, final long maxTime){
                 final HttpContext httpContext = createContext(context, (HttpExchange exchange) -> {
                     handler.handle(exchange);
@@ -236,6 +239,8 @@ public synchronized final HttpContext createTemporaryContext(final String contex
                 return httpContext;
             }
 
+            // endregion
+
             //
 
             @Override
@@ -275,7 +280,27 @@ public final Map<HttpContext, HttpHandler> getContexts(){
                 return new HashMap<>(contexts);
             }
 
-        //
+            //
+
+            @Override
+            public synchronized final String getRandomContext(){
+                return getRandomContext("/");
+            }
+
+            @Override
+            public synchronized final String getRandomContext(final String context){
+                String targetContext;
+
+                final String head = getContext(context);
+
+                do targetContext = head + '/' + UUID.randomUUID().toString();
+                    while(getContextHandler(targetContext) != null);
+
+                return targetContext;
+            }
+
+
+            //
 
             @Override
             public synchronized final void start(){
@@ -316,6 +341,7 @@ public final String toString(){
         };
     }
 
+    // start slash; no end slash
     private static String getContext(final String path){
         final String linSlash = path.replace("\\","/");
         if(linSlash.equals("/")) return "/";

src/main/java/com/kttdevelopment/simplehttpserver/handler/TemporaryHandler.java

@@ -1,5 +1,6 @@
 package com.kttdevelopment.simplehttpserver.handler;
 
+import com.kttdevelopment.simplehttpserver.SimpleHttpServer;
 import com.sun.net.httpserver.HttpExchange;
 import com.sun.net.httpserver.HttpHandler;
 
@@ -9,6 +10,8 @@
  * A temporary handler handles a single request and then removes itself from the server. This can be used for single use downloads, or media file hosting.
  *
  * @see HttpHandler
+ * @see SimpleHttpServer#getRandomContext()
+ * @see SimpleHttpServer#getRandomContext(String)
  * @since 03.03.00
  * @version 03.03.00
  * @author Ktt Development