RequestLine xref

    1   /*
    2    * $Header: /home/jerenkrantz/tmp/commons/commons-convert/cvs/home/cvs/jakarta-commons//httpclient/src/test/org/apache/commons/httpclient/server/RequestLine.java,v 1.4 2004/09/14 15:50:41 olegk Exp $
    3    * $Revision: 480424 $
    4    * $Date: 2006-11-29 06:56:49 +0100 (Wed, 29 Nov 2006) $
    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   * [Additional notices, if required by prior licensing conditions]
    30   *
    31   */
    32
    33  package org.apache.commons.httpclient.server;
    34
    35  import java.util.NoSuchElementException;
    36  import java.util.StringTokenizer;
    37
    38  import org.apache.commons.httpclient.HttpException;
    39  import org.apache.commons.httpclient.HttpVersion;
    40  import org.apache.commons.httpclient.ProtocolException;
    41
    42  /**
    43   * Defines a HTTP request-line, consisting of method name, URI and protocol.
    44   * Instances of this class are immutable.
    45   *
    46   * @author Christian Kohlschuetter
    47   * @author Oleg Kalnichevski
    48   */
    49  public class RequestLine {
    50
    51      private HttpVersion httpversion = null;
    52      private String method = null;
    53      private String uri= null;
    54
    55      public static RequestLine parseLine(final String l)
    56      throws HttpException {
    57          String method = null;
    58          String uri = null;
    59          String protocol = null;
    60          try {
    61              StringTokenizer st = new StringTokenizer(l, " ");
    62              method = st.nextToken();
    63              uri = st.nextToken();
    64              protocol = st.nextToken();
    65          } catch (NoSuchElementException e) {
    66          	throw new ProtocolException("Invalid request line: " + l);
    67          }
    68          return new RequestLine(method, uri, protocol);
    69      }
    70
    71      public RequestLine(final String method, final String uri, final HttpVersion httpversion) {
    72      	super();
    73      	if (method == null) {
    74      		throw new IllegalArgumentException("Method may not be null");
    75      	}
    76      	if (uri == null) {
    77      		throw new IllegalArgumentException("URI may not be null");
    78      	}
    79      	if (httpversion == null) {
    80      		throw new IllegalArgumentException("HTTP version may not be null");
    81      	}
    82      	this.method = method;
    83          this.uri = uri;
    84          this.httpversion = httpversion;
    85      }
    86
    87      public RequestLine(final String method, final String uri, final String httpversion)
    88      throws ProtocolException {
    89      	this(method, uri, HttpVersion.parse(httpversion));
    90      }
    91
    92      public String getMethod() {
    93          return this.method;
    94      }
    95
    96      public HttpVersion getHttpVersion() {
    97          return this.httpversion;
    98      }
    99
    100     public String getUri() {
    101         return this.uri;
    102     }
    103
    104     public String toString() {
    105         StringBuffer sb = new StringBuffer();
    106         sb.append(this.method);
    107         sb.append(" ");
    108         sb.append(this.uri);
    109         sb.append(" ");
    110         sb.append(this.httpversion);
    111         return sb.toString();
    112     }
    113 }