View Javadoc

1   /*
2    * $HeadURL: https://svn.apache.org/repos/asf/httpcomponents/oac.hc3x/trunk/src/java/org/apache/commons/httpclient/methods/PutMethod.java $
3    * $Revision$
4    * $Date$
5    *
6    * ====================================================================
7    *
8    *  Licensed to the Apache Software Foundation (ASF) under one or more
9    *  contributor license agreements.  See the NOTICE file distributed with
10   *  this work for additional information regarding copyright ownership.
11   *  The ASF licenses this file to You under the Apache License, Version 2.0
12   *  (the "License"); you may not use this file except in compliance with
13   *  the License.  You may obtain a copy of the License at
14   *
15   *      http://www.apache.org/licenses/LICENSE-2.0
16   *
17   *  Unless required by applicable law or agreed to in writing, software
18   *  distributed under the License is distributed on an "AS IS" BASIS,
19   *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20   *  See the License for the specific language governing permissions and
21   *  limitations under the License.
22   * ====================================================================
23   *
24   * This software consists of voluntary contributions made by many
25   * individuals on behalf of the Apache Software Foundation.  For more
26   * information on the Apache Software Foundation, please see
27   * <http://www.apache.org/>.
28   *
29   */
30  
31  package org.apache.commons.httpclient.methods;
32  
33  /***
34   * Implements the HTTP PUT method.
35   * <p>
36   * The HTTP PUT method is defined in section 9.6 of 
37   * <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC2616</a>:
38   * <blockquote>
39   * The PUT method requests that the enclosed entity be stored under the
40   * supplied Request-URI. If the Request-URI refers to an already
41   * existing resource, the enclosed entity SHOULD be considered as a
42   * modified version of the one residing on the origin server. 
43   * </blockquote>
44   * </p>
45   * 
46   * @author <a href="mailto:remm@apache.org">Remy Maucherat</a>
47   * @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a>
48   * @author <a href="mailto:oleg@ural.ru">Oleg Kalnichevski</a>
49   * @author <a href="mailto:jsdever@apache.org">Jeff Dever</a>
50   *
51   * @version $Revision$
52   * @since 1.0
53   */
54  public class PutMethod extends EntityEnclosingMethod {
55  
56      // ----------------------------------------------------------- Constructors
57  
58      /***
59       * No-arg constructor.
60       *
61       * @since 1.0
62       */
63      public PutMethod() {
64          super();
65      }
66  
67  
68      /***
69       * Constructor specifying a URI.
70       *
71       * @param uri either an absolute or relative URI
72       *
73       * @since 1.0
74       */
75      public PutMethod(String uri) {
76          super(uri);
77      }
78  
79      // --------------------------------------------------------- Public Methods
80  
81      /***
82       * Return <tt>"PUT"</tt>.
83       * @return <tt>"PUT"</tt>
84       *
85       * @since 2.0
86       */
87      public String getName() {
88          return "PUT";
89      }
90  }