1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/mobile/android/thirdparty/ch/boye/httpclientandroidlib/client/methods/HttpOptions.java Wed Dec 31 06:09:35 2014 +0100 1.3 @@ -0,0 +1,102 @@ 1.4 +/* 1.5 + * ==================================================================== 1.6 + * Licensed to the Apache Software Foundation (ASF) under one 1.7 + * or more contributor license agreements. See the NOTICE file 1.8 + * distributed with this work for additional information 1.9 + * regarding copyright ownership. The ASF licenses this file 1.10 + * to you under the Apache License, Version 2.0 (the 1.11 + * "License"); you may not use this file except in compliance 1.12 + * with the License. You may obtain a copy of the License at 1.13 + * 1.14 + * http://www.apache.org/licenses/LICENSE-2.0 1.15 + * 1.16 + * Unless required by applicable law or agreed to in writing, 1.17 + * software distributed under the License is distributed on an 1.18 + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 1.19 + * KIND, either express or implied. See the License for the 1.20 + * specific language governing permissions and limitations 1.21 + * under the License. 1.22 + * ==================================================================== 1.23 + * 1.24 + * This software consists of voluntary contributions made by many 1.25 + * individuals on behalf of the Apache Software Foundation. For more 1.26 + * information on the Apache Software Foundation, please see 1.27 + * <http://www.apache.org/>. 1.28 + * 1.29 + */ 1.30 + 1.31 +package ch.boye.httpclientandroidlib.client.methods; 1.32 + 1.33 +import java.net.URI; 1.34 +import java.util.HashSet; 1.35 +import java.util.Set; 1.36 + 1.37 +import ch.boye.httpclientandroidlib.annotation.NotThreadSafe; 1.38 + 1.39 +import ch.boye.httpclientandroidlib.Header; 1.40 +import ch.boye.httpclientandroidlib.HeaderElement; 1.41 +import ch.boye.httpclientandroidlib.HeaderIterator; 1.42 +import ch.boye.httpclientandroidlib.HttpResponse; 1.43 + 1.44 +/** 1.45 + * HTTP OPTIONS method. 1.46 + * <p> 1.47 + * The HTTP OPTIONS method is defined in section 9.2 of 1.48 + * <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC2616</a>: 1.49 + * <blockquote> 1.50 + * The OPTIONS method represents a request for information about the 1.51 + * communication options available on the request/response chain 1.52 + * identified by the Request-URI. This method allows the client to 1.53 + * determine the options and/or requirements associated with a resource, 1.54 + * or the capabilities of a server, without implying a resource action 1.55 + * or initiating a resource retrieval. 1.56 + * </blockquote> 1.57 + * </p> 1.58 + * 1.59 + * @since 4.0 1.60 + */ 1.61 +@NotThreadSafe 1.62 +public class HttpOptions extends HttpRequestBase { 1.63 + 1.64 + public final static String METHOD_NAME = "OPTIONS"; 1.65 + 1.66 + public HttpOptions() { 1.67 + super(); 1.68 + } 1.69 + 1.70 + public HttpOptions(final URI uri) { 1.71 + super(); 1.72 + setURI(uri); 1.73 + } 1.74 + 1.75 + /** 1.76 + * @throws IllegalArgumentException if the uri is invalid. 1.77 + */ 1.78 + public HttpOptions(final String uri) { 1.79 + super(); 1.80 + setURI(URI.create(uri)); 1.81 + } 1.82 + 1.83 + @Override 1.84 + public String getMethod() { 1.85 + return METHOD_NAME; 1.86 + } 1.87 + 1.88 + public Set<String> getAllowedMethods(final HttpResponse response) { 1.89 + if (response == null) { 1.90 + throw new IllegalArgumentException("HTTP response may not be null"); 1.91 + } 1.92 + 1.93 + HeaderIterator it = response.headerIterator("Allow"); 1.94 + Set<String> methods = new HashSet<String>(); 1.95 + while (it.hasNext()) { 1.96 + Header header = it.nextHeader(); 1.97 + HeaderElement[] elements = header.getElements(); 1.98 + for (HeaderElement element : elements) { 1.99 + methods.add(element.getName()); 1.100 + } 1.101 + } 1.102 + return methods; 1.103 + } 1.104 + 1.105 +}