mobile/android/thirdparty/ch/boye/httpclientandroidlib/client/methods/HttpPost.java

Thu, 22 Jan 2015 13:21:57 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Thu, 22 Jan 2015 13:21:57 +0100
branch
TOR_BUG_9701
changeset 15
b8a032363ba2
permissions
-rw-r--r--

Incorporate requested changes from Mozilla in review:
https://bugzilla.mozilla.org/show_bug.cgi?id=1123480#c6

     1 /*
     2  * ====================================================================
     3  * Licensed to the Apache Software Foundation (ASF) under one
     4  * or more contributor license agreements.  See the NOTICE file
     5  * distributed with this work for additional information
     6  * regarding copyright ownership.  The ASF licenses this file
     7  * to you under the Apache License, Version 2.0 (the
     8  * "License"); you may not use this file except in compliance
     9  * with the License.  You may obtain a copy of the License at
    10  *
    11  *   http://www.apache.org/licenses/LICENSE-2.0
    12  *
    13  * Unless required by applicable law or agreed to in writing,
    14  * software distributed under the License is distributed on an
    15  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    16  * KIND, either express or implied.  See the License for the
    17  * specific language governing permissions and limitations
    18  * under the License.
    19  * ====================================================================
    20  *
    21  * This software consists of voluntary contributions made by many
    22  * individuals on behalf of the Apache Software Foundation.  For more
    23  * information on the Apache Software Foundation, please see
    24  * <http://www.apache.org/>.
    25  *
    26  */
    28 package ch.boye.httpclientandroidlib.client.methods;
    30 import java.net.URI;
    32 import ch.boye.httpclientandroidlib.annotation.NotThreadSafe;
    34 /**
    35  * HTTP POST method.
    36  * <p>
    37  * The HTTP POST method is defined in section 9.5 of
    38  * <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC2616</a>:
    39  * <blockquote>
    40  * The POST method is used to request that the origin server accept the entity
    41  * enclosed in the request as a new subordinate of the resource identified by
    42  * the Request-URI in the Request-Line. POST is designed to allow a uniform
    43  * method to cover the following functions:
    44  * <ul>
    45  *   <li>Annotation of existing resources</li>
    46  *   <li>Posting a message to a bulletin board, newsgroup, mailing list, or
    47  *     similar group of articles</li>
    48  *   <li>Providing a block of data, such as the result of submitting a form,
    49  *     to a data-handling process</li>
    50  *   <li>Extending a database through an append operation</li>
    51  * </ul>
    52  * </blockquote>
    53  * </p>
    54  *
    55  * @since 4.0
    56  */
    57 @NotThreadSafe
    58 public class HttpPost extends HttpEntityEnclosingRequestBase {
    60     public final static String METHOD_NAME = "POST";
    62     public HttpPost() {
    63         super();
    64     }
    66     public HttpPost(final URI uri) {
    67         super();
    68         setURI(uri);
    69     }
    71     /**
    72      * @throws IllegalArgumentException if the uri is invalid.
    73      */
    74     public HttpPost(final String uri) {
    75         super();
    76         setURI(URI.create(uri));
    77     }
    79     @Override
    80     public String getMethod() {
    81         return METHOD_NAME;
    82     }
    84 }

mercurial