hazendaz / httpunit / 389

Committed 12 Aug 2025 11:17PM UTC coverage: 80.48% (-0.02%) from 80.503%

Build # 389

Build Type

push

github

Committed by

hazendaz

Commit Message

Merge branch 'master' into javax

Run Details

3216 of 4105 branches covered (78.34%)

Branch coverage included in aggregate %.

238 of 258 new or added lines in 68 files covered. (92.25%)

2 existing lines in 2 files now uncovered.

8254 of 10147 relevant lines covered (81.34%)

0.81 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

25.0

/src/main/java/com/meterware/httpunit/ParameterHolder.java

/*
 * MIT License
 *
 * Copyright 2011-2025 Russell Gold
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
 * documentation files (the "Software"), to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and
 * to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all copies or substantial portions
 * of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
 * THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
 * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 * DEALINGS IN THE SOFTWARE.
 */
package com.meterware.httpunit;

import com.meterware.httpunit.protocol.ParameterCollection;
import com.meterware.httpunit.protocol.ParameterProcessor;
import com.meterware.httpunit.protocol.UploadFileSpec;

import java.io.IOException;
import java.nio.charset.StandardCharsets;

/**
 * This abstract class is extended by classes which hold parameters for web requests. Note that it is an abstract class
 * rather than an interface in order to keep its methods package-local.
 *
 * @author <a href="mailto:russgold@httpunit.org">Russell Gold</a>
 **/
abstract class ParameterHolder implements ParameterCollection {

    /**
     * Specifies the position at which an image button (if any) was clicked. This default implementation does nothing.
     **/
    void selectImageButtonPosition(SubmitButton imageButton, int x, int y) {
    }

    /**
     * Iterates through the fixed, predefined parameters in this holder, recording them in the supplied parameter
     * processor.\ These parameters always go on the URL, no matter what encoding method is used.
     **/
    abstract void recordPredefinedParameters(ParameterProcessor processor) throws IOException;

    /**
     * Returns an array of all parameter names in this collection.
     **/
    abstract String[] getParameterNames();

    /**
     * Returns the multiple default values of the named parameter.
     **/
    abstract String[] getParameterValues(String name);

    /**
     * Removes a parameter name from this collection.
     **/
    abstract void removeParameter(String name);

    /**
     * Sets the value of a parameter in a web request.
     **/
    abstract void setParameter(String name, String value);

    /**
     * Sets the multiple values of a parameter in a web request.
     **/
    abstract void setParameter(String name, String[] values);

    /**
     * Sets the multiple values of a file upload parameter in a web request.
     **/
    abstract void setParameter(String name, UploadFileSpec[] files);

    /**
     * Returns true if the specified name is that of a file parameter. The default implementation returns false.
     */
    boolean isFileParameter(String name) {
        return false;
    }

    /**
     * Returns the character set encoding for the request.
     **/
    String getCharacterSet() {
        return StandardCharsets.ISO_8859_1.name();
    }

    abstract boolean isSubmitAsMime();
}

1	/*
2	* MIT License
3	*
4	* Copyright 2011-2025 Russell Gold
5	*
6	* Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
7	* documentation files (the "Software"), to deal in the Software without restriction, including without limitation
8	* the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and
9	* to permit persons to whom the Software is furnished to do so, subject to the following conditions:
10	*
11	* The above copyright notice and this permission notice shall be included in all copies or substantial portions
12	* of the Software.
13	*
14	* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
15	* THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
16	* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
17	* CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
18	* DEALINGS IN THE SOFTWARE.
19	*/
20	package com.meterware.httpunit;
21
22	import com.meterware.httpunit.protocol.ParameterCollection;
23	import com.meterware.httpunit.protocol.ParameterProcessor;
24	import com.meterware.httpunit.protocol.UploadFileSpec;
25
26	import java.io.IOException;
27	import java.nio.charset.StandardCharsets;
28
29	/**
30	* This abstract class is extended by classes which hold parameters for web requests. Note that it is an abstract class
31	* rather than an interface in order to keep its methods package-local.
32	*
33	* @author <a href="mailto:russgold@httpunit.org">Russell Gold</a>
34	**/
35	abstract class ParameterHolder implements ParameterCollection {	1✔
36
37	/**
38	* Specifies the position at which an image button (if any) was clicked. This default implementation does nothing.
39	**/
40	void selectImageButtonPosition(SubmitButton imageButton, int x, int y) {
41	}	×
42
43	/**
44	* Iterates through the fixed, predefined parameters in this holder, recording them in the supplied parameter
45	* processor.\ These parameters always go on the URL, no matter what encoding method is used.
46	**/
47	abstract void recordPredefinedParameters(ParameterProcessor processor) throws IOException;
48
49	/**
50	* Returns an array of all parameter names in this collection.
51	**/
52	abstract String[] getParameterNames();
53
54	/**
55	* Returns the multiple default values of the named parameter.
56	**/
57	abstract String[] getParameterValues(String name);
58
59	/**
60	* Removes a parameter name from this collection.
61	**/
62	abstract void removeParameter(String name);
63
64	/**
65	* Sets the value of a parameter in a web request.
66	**/
67	abstract void setParameter(String name, String value);
68
69	/**
70	* Sets the multiple values of a parameter in a web request.
71	**/
72	abstract void setParameter(String name, String[] values);
73
74	/**
75	* Sets the multiple values of a file upload parameter in a web request.
76	**/
77	abstract void setParameter(String name, UploadFileSpec[] files);
78
79	/**
80	* Returns true if the specified name is that of a file parameter. The default implementation returns false.
81	*/
82	boolean isFileParameter(String name) {
83	return false;	×
84	}
85
86	/**
87	* Returns the character set encoding for the request.
88	**/
89	String getCharacterSet() {
NEW 90	return StandardCharsets.ISO_8859_1.name();	×
91	}
92
93	abstract boolean isSubmitAsMime();
94	}

hazendaz / httpunit / 389

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous