How to obtain the query string in a GET with Java HttpServer/HttpExchange?

Question

I am trying to create a simple HttpServer in Java to handle GET requests, but when I try to get the GET parameters for a request I noticed the HttpExchange class does not have a method for that.

Does anybody know an easy way to read the GET parameters (query string)?

This is how my handler looks like:

public class TestHandler{
  @Override
  public void handle(HttpExchange exc) throws IOxception {
    String response = "This is the reponse";
    exc.sendResponseHeaders(200, response.length());

    // need GET params here

    OutputStream os = exc.getResponseBody();
    os.write(response.getBytes());
    os.close();
  } 
}

.. and the main method:

public static void main(String[] args) throws Exception{
  // create server on port 8000
  InetSocketAddress address = new InetSocketAddress(8000);
  HttpServer server = new HttpServer.create(address, 0);

  // bind handler
  server.createContext("/highscore", new TestHandler());
  server.setExecutor(null);
  server.start();
}

An easy way? Parse the URI; it's just a get request. If you have to handle posts, things like this might help. — Dave Newton
– Dave Newton, Commented Jul 24, 2012 at 22:16

glegoux · Accepted Answer · 2024-11-13 16:32:05Z

57

The following: httpExchange.getRequestURI().getQuery()

will return string in format similar to this: "field1=value1&field2=value2&field3=value3..."

so you could simply parse string yourself, this is how function for parsing could look like:

import java.net.URLDecoder

public Map<String, String> queryToMap(String query) {
    if (query == null) {
        return null;
    }
    Map<String, String> result = new HashMap<>();
    for (String param : query.split("&")) {
        String[] entry = param.split("=");
        if (entry.length > 1) {
            result.put(
                URLDecoder.decode(entry[0], "UTF_8"), 
                URLDecoder.decode(entry[1], "UTF_8")
            );
        } else {
            result.put(
                URLDecoder.decode(entry[0], "UTF_8"),
                ""
            );
        }
    }
    return result;
}

And this is how you could use it:

Map<String, String> params = queryToMap(httpExchange.getRequestURI().getQuery()); 
System.out.println("param A=" + params.get("A"));

Note: URLDecoder.decode allows to manage special characters liek +.

edited Nov 13, 2024 at 16:32

glegoux

3,62317 silver badges32 bronze badges

answered Jul 4, 2013 at 14:08

anon01

5866 silver badges4 bronze badges

Sign up to request clarification or add additional context in comments.

7 Comments

MinecraftShamrock Over a year ago

Important to know: The query could be null. You should check that.

Evan Over a year ago

Thanks for this answer! It fails for params whose value includes an ampersand, though. To fix, use getRawQuery() instead of getQuery(), then param = java.net.URLDecoder.decode(param, "UTF-8") after splitting on "&".

Gurusharan S Over a year ago

@Evan, I believe the decoding should happen when putting the value into the Map - that way you don't lose part of the value if there's an '=' in it.

Datz Over a year ago

It should be param.split("=", 2); in case the value contains a =. (btw this solution does not support double keys like x=111&x=222)

Datz Over a year ago

@ssi-anik try for example this URL: https://www.google.com/?q=hello&q=ssi-anik Many framework/programming languages create an array of the values. (eg q[0]=hello q[1]=ssi-anik

|

Oliv · Accepted Answer · 2017-01-12 10:32:26Z

This answer, contrary to annon01's, properly decodes the keys and values. It does not use String.split, but scans the string using indexOf, which is faster.

public static Map<String, String> parseQueryString(String qs) {
    Map<String, String> result = new HashMap<>();
    if (qs == null)
        return result;

    int last = 0, next, l = qs.length();
    while (last < l) {
        next = qs.indexOf('&', last);
        if (next == -1)
            next = l;

        if (next > last) {
            int eqPos = qs.indexOf('=', last);
            try {
                if (eqPos < 0 || eqPos > next)
                    result.put(URLDecoder.decode(qs.substring(last, next), "utf-8"), "");
                else
                    result.put(URLDecoder.decode(qs.substring(last, eqPos), "utf-8"), URLDecoder.decode(qs.substring(eqPos + 1, next), "utf-8"));
            } catch (UnsupportedEncodingException e) {
                throw new RuntimeException(e); // will never happen, utf-8 support is mandatory for java
            }
        }
        last = next + 1;
    }
    return result;
}

Wim Deblauwe · Accepted Answer · 2015-08-31 09:10:06Z

1

Building on the answer by @anon01, this is how to do it in Groovy:

Map<String,String> getQueryParameters( HttpExchange httpExchange )
{
    def query = httpExchange.getRequestURI().getQuery()
    return query.split( '&' )
            .collectEntries {
        String[] pair = it.split( '=' )
        if (pair.length > 1)
        {
            return [(pair[0]): pair[1]]
        }
        else
        {
            return [(pair[0]): ""]
        }
    }
}

And this is how to use it:

def queryParameters = getQueryParameters( httpExchange )
def parameterA = queryParameters['A']

answered Aug 31, 2015 at 9:10

Wim Deblauwe

27.2k23 gold badges156 silver badges234 bronze badges

1 Comment

Tibor Over a year ago

Well, thank you. But the question is for Java, not Goovy ;)

Brian · Accepted Answer · 2020-09-20 07:47:22Z

Stumbled across this, and figured I'd toss a Java 8 / Streams implementation out here, whilst adding a few extra bits (not in previous answers).

Extra 1: I've added a filter to avoid processing any empty params. Something that should not happen, but it allows a cleaner implementation vs. not handling the issue (and sending an empty response). An example of this would look like ?param1=value1&param2=

Extra 2: I've leveraged String.split(String regex, int limit) for the second split operation. This allows a query parameter such as ?param1=it_has=in-it&other=something to be passed.

public static Map<String, String> getParamMap(String query) {
    // query is null if not provided (e.g. localhost/path )
    // query is empty if '?' is supplied (e.g. localhost/path? )
    if (query == null || query.isEmpty()) return Collections.emptyMap();

    return Stream.of(query.split("&"))
            .filter(s -> !s.isEmpty())
            .map(kv -> kv.split("=", 2)) 
            .collect(Collectors.toMap(x -> x[0], x-> x[1]));

}

Imports

import java.util.Map;
import java.util.Collections;
import java.util.stream.Stream;
import java.util.stream.Collectors;

Babak Farhang · Accepted Answer · 2022-08-23 19:04:42Z

If, like me, your query string allows the same name to occur multiple times, the you'll want the values to be lists (like in Netty's QueryStringDecoder). Adapted from the best answer here..

  final static Charset UTF_8 = Charset.forName("UTF-8");

  static Map<String, List<String>> queryMap(HttpExchange exchange) {
    return queryMap(exchange.getRequestURI().getRawQuery());
  }
  
  static Map<String, List<String>> queryMap(String query) {
    if (query == null || query.isEmpty()) {
      return Map.of();
    }
    Map<String, List<String>> result = new HashMap<>();
    for (String param : query.split("&")) {
      String[] entry = param.split("=");
      var name = entry[0];
      var list = result.get(name);
      if (list == null) {
        list = new ArrayList<>(2);
        result.put(name, list);
      }
      String value = entry.length > 1 ?
            URLDecoder.decode(entry[1], UTF_8) : "";
      
      list.add(value);
    }
    return result;
  }

Collectives™ on Stack Overflow

How to obtain the query string in a GET with Java HttpServer/HttpExchange?

5 Answers 5

7 Comments

Comments

1 Comment

Comments

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

5 Answers 5

7 Comments

Comments

1 Comment

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related