001: /*
002: * Copyright (c) 2002-2008 Gargoyle Software Inc. All rights reserved.
003: *
004: * Redistribution and use in source and binary forms, with or without
005: * modification, are permitted provided that the following conditions are met:
006: *
007: * 1. Redistributions of source code must retain the above copyright notice,
008: * this list of conditions and the following disclaimer.
009: * 2. Redistributions in binary form must reproduce the above copyright notice,
010: * this list of conditions and the following disclaimer in the documentation
011: * and/or other materials provided with the distribution.
012: * 3. The end-user documentation included with the redistribution, if any, must
013: * include the following acknowledgment:
014: *
015: * "This product includes software developed by Gargoyle Software Inc.
016: * (http://www.GargoyleSoftware.com/)."
017: *
018: * Alternately, this acknowledgment may appear in the software itself, if
019: * and wherever such third-party acknowledgments normally appear.
020: * 4. The name "Gargoyle Software" must not be used to endorse or promote
021: * products derived from this software without prior written permission.
022: * For written permission, please contact info@GargoyleSoftware.com.
023: * 5. Products derived from this software may not be called "HtmlUnit", nor may
024: * "HtmlUnit" appear in their name, without prior written permission of
025: * Gargoyle Software Inc.
026: *
027: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
028: * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
029: * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GARGOYLE
030: * SOFTWARE INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
031: * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
032: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
033: * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
034: * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
035: * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
036: * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
037: */
038: package com.gargoylesoftware.htmlunit;
039:
040: import org.apache.commons.httpclient.methods.PostMethod;
041:
042: /**
043: * A collection of constants that represent the various ways a form can be
044: * encoded when submitted
045: *
046: * @version $Revision: 2132 $
047: * @author Brad Clarke
048: */
049: public final class FormEncodingType {
050:
051: /**
052: * URL_ENCODED
053: */
054: public static final FormEncodingType URL_ENCODED = new FormEncodingType(
055: PostMethod.FORM_URL_ENCODED_CONTENT_TYPE);
056: /**
057: * MULTIPART
058: * This used to be a constant in HttpClient but it was deprecated with no alternative.
059: */
060: public static final FormEncodingType MULTIPART = new FormEncodingType(
061: "multipart/form-data");
062:
063: private final String name_;
064:
065: private FormEncodingType(final String name) {
066: name_ = name;
067: }
068:
069: /**
070: * Return the name of this EncodingType
071: *
072: * @return See above
073: */
074: public String getName() {
075: return name_;
076: }
077:
078: /**
079: * Return the constant that matches the given name
080: *
081: * @param name The name to search by
082: * @return See above
083: */
084: public static FormEncodingType getInstance(final String name) {
085: final String lowerCaseName = name.toLowerCase();
086: final FormEncodingType allInstances[] = new FormEncodingType[] {
087: URL_ENCODED, MULTIPART };
088:
089: int i;
090: for (i = 0; i < allInstances.length; i++) {
091: if (allInstances[i].getName().equals(lowerCaseName)) {
092: return allInstances[i];
093: }
094: }
095:
096: // Special case: empty string defaults to url encoded
097: if (name.equals("")) {
098: return URL_ENCODED;
099: }
100:
101: throw new IllegalArgumentException(
102: "No encoding type found for [" + name + "]");
103: }
104:
105: /**
106: * Return a string representation of this object
107: *
108: * @return See above
109: */
110: public String toString() {
111: return "EncodingType[name=" + getName() + "]";
112: }
113: }
|