hazendaz / httpunit / 656

Committed 06 Dec 2025 09:11PM UTC coverage: 80.452% (+0.02%) from 80.435%

Build # 656

Build Type

push

github

Committed by

hazendaz

Commit Message

[maven-release-plugin] prepare for next development iteration

Run Details

3213 of 4105 branches covered (78.27%)

Branch coverage included in aggregate %.

8245 of 10137 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.
 **/
abstract class ParameterHolder implements ParameterCollection {

    /**
     * Specifies the position at which an image button (if any) was clicked. This default implementation does nothing.
     *
     * @param imageButton
     *            the image button
     * @param x
     *            the x
     * @param y
     *            the y
     */
    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.
     *
     * @param processor
     *            the processor
     *
     * @throws IOException
     *             Signals that an I/O exception has occurred.
     */
    abstract void recordPredefinedParameters(ParameterProcessor processor) throws IOException;

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

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

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

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

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

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

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

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

    /**
     * Checks if is submit as mime.
     *
     * @return true, if is submit as mime
     */
    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	abstract class ParameterHolder implements ParameterCollection {	1✔
34
35	/**
36	* Specifies the position at which an image button (if any) was clicked. This default implementation does nothing.
37	*
38	* @param imageButton
39	* the image button
40	* @param x
41	* the x
42	* @param y
43	* the y
44	*/
45	void selectImageButtonPosition(SubmitButton imageButton, int x, int y) {
46	}	×
47
48	/**
49	* Iterates through the fixed, predefined parameters in this holder, recording them in the supplied parameter
50	* processor.\ These parameters always go on the URL, no matter what encoding method is used.
51	*
52	* @param processor
53	* the processor
54	*
55	* @throws IOException
56	* Signals that an I/O exception has occurred.
57	*/
58	abstract void recordPredefinedParameters(ParameterProcessor processor) throws IOException;
59
60	/**
61	* Returns an array of all parameter names in this collection.
62	*
63	* @return the parameter names
64	*/
65	abstract String[] getParameterNames();
66
67	/**
68	* Returns the multiple default values of the named parameter.
69	*
70	* @param name
71	* the name
72	*
73	* @return the parameter values
74	*/
75	abstract String[] getParameterValues(String name);
76
77	/**
78	* Removes a parameter name from this collection.
79	*
80	* @param name
81	* the name
82	*/
83	abstract void removeParameter(String name);
84
85	/**
86	* Sets the value of a parameter in a web request.
87	*
88	* @param name
89	* the name
90	* @param value
91	* the value
92	*/
93	abstract void setParameter(String name, String value);
94
95	/**
96	* Sets the multiple values of a parameter in a web request.
97	*
98	* @param name
99	* the name
100	* @param values
101	* the values
102	*/
103	abstract void setParameter(String name, String[] values);
104
105	/**
106	* Sets the multiple values of a file upload parameter in a web request.
107	*
108	* @param name
109	* the name
110	* @param files
111	* the files
112	*/
113	abstract void setParameter(String name, UploadFileSpec[] files);
114
115	/**
116	* Returns true if the specified name is that of a file parameter. The default implementation returns false.
117	*
118	* @param name
119	* the name
120	*
121	* @return true, if is file parameter
122	*/
123	boolean isFileParameter(String name) {
124	return false;	×
125	}
126
127	/**
128	* Returns the character set encoding for the request.
129	*
130	* @return the character set
131	*/
132	String getCharacterSet() {
133	return StandardCharsets.ISO_8859_1.name();	×
134	}
135
136	/**
137	* Checks if is submit as mime.
138	*
139	* @return true, if is submit as mime
140	*/
141	abstract boolean isSubmitAsMime();
142	}

hazendaz / httpunit / 656

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