FunctionalTesting.java

package com.renomad.minum.web;

import com.renomad.minum.state.Constants;

import com.renomad.minum.htmlparsing.HtmlParseNode;

import com.renomad.minum.htmlparsing.HtmlParser;

import com.renomad.minum.htmlparsing.TagName;

import com.renomad.minum.logging.ILogger;

import com.renomad.minum.state.Context;

import com.renomad.minum.utils.InvariantException;

import com.renomad.minum.utils.StacktraceUtils;

import java.io.IOException;

import java.io.InputStream;

import java.net.Socket;

import java.nio.charset.StandardCharsets;

import java.util.ArrayList;

import java.util.List;

import java.util.Map;

import java.util.regex.Matcher;

import java.util.regex.Pattern;

import static com.renomad.minum.utils.Invariants.mustBeTrue;

/**

 * Tools to enable system-wide integration testing

 */

public final class FunctionalTesting {

    private final String host;

    private final int port;

    private final IInputStreamUtils inputStreamUtils;

    private final ILogger logger;

    private final Constants constants;

    private final IBodyProcessor bodyProcessor;

    /**

     * Allows the user to set the host and port to target

     * for testing.

     */

    /**

     * A {@link Response} designed to work with {@link FunctionalTesting}

     */

        /**

         * Presuming the response body is HTML, search for a single

         * HTML element with the given tag name and attributes.

         *

         * @return {@link HtmlParseNode#EMPTY} if none found, a particular node if found,

         * and an exception thrown if more than one found.

         */

        public HtmlParseNode searchOne(TagName tagName, Map<String, String> attributes) {

            }

            } else {

            }

        }

        /**

         * Presuming the response body is HTML, search for all

         * HTML elements with the given tag name and attributes.

         *

         * @return a list of however many elements matched

         */

        public List<HtmlParseNode> search(TagName tagName, Map<String, String> attributes) {

        }

    }

    /**

     * Send a GET request (as a client to the server)

     * @param path the path to an endpoint, that is, the value for path

     *            that is entered in {@link WebFramework#registerPath(RequestLine.Method, String, ThrowingFunction)}

     *             for pathname

     */

    public TestResponse get(String path) {

    }

    /**

     * Send a GET request (as a client to the server)

     * @param path the path to an endpoint, that is, the value for path

     *            that is entered in {@link WebFramework#registerPath(RequestLine.Method, String, ThrowingFunction)}

     *             for pathname

     * @param extraHeaders a list containing extra headers you need the client to send, for

     *                     example, <pre>{@code List.of("cookie: id=foo")}</pre>

     */

    public TestResponse get(String path, List<String> extraHeaders) {

    }

    /**

     * Send a POST request (as a client to the server) using url encoding

     * @param path the path to an endpoint, that is, the value for path

     *            that is entered in {@link WebFramework#registerPath(RequestLine.Method, String, ThrowingFunction)}

     *             for pathname

     * @param payload a body payload in string form

     */

    public TestResponse post(String path, String payload) {

    }

    /**

     * Send a POST request (as a client to the server) using url encoding

     * @param path the path to an endpoint, that is, the value for path

     *            that is entered in {@link WebFramework#registerPath(RequestLine.Method, String, ThrowingFunction)}

     *             for pathname

     * @param payload a body payload in string form

     * @param extraHeaders a list containing extra headers you need the client to send, for

     *                     example, <pre>{@code List.of("cookie: id=foo")}</pre>

     */

    public TestResponse post(String path, String payload, List<String> extraHeaders) {

    }

    /**

     * Send a request as a client to the server

     * <p>

     *     This helper method is the same as {@link #send(RequestLine.Method, String, byte[], List)} except

     *     it will set the body as empty and does not require any extra headers to be set. In this

     *     case, the headers sent are very minimal.  See the source.

     * </p>

     * @param path the path to an endpoint, that is, the value for path

     *            that is entered in {@link WebFramework#registerPath(RequestLine.Method, String, ThrowingFunction)}

     *             for pathname

     */

    public TestResponse send(RequestLine.Method method, String path) {

    }

    /**

     * Send a request as a client to the server

     * @param path the path to an endpoint, that is, the value for path

     *            that is entered in {@link WebFramework#registerPath(RequestLine.Method, String, ThrowingFunction)}

     *             for pathname

     * @param payload a body payload in byte array form

     * @param extraHeaders a list containing extra headers you need the client to send, for

     *                     example, <pre>{@code List.of("cookie: id=foo")}</pre>

     * @return a properly-built client, or null if exceptions occur

     */

    public TestResponse send(RequestLine.Method method, String path, byte[] payload, List<String> extraHeaders) {

        }

    }

    public TestResponse innerClientSend(

            ISocketWrapper client,

            RequestLine.Method method,

            String path,

            byte[] payload,

            List<String> extraHeaders) throws IOException {

        List<String> allHeaders;

        StatusLine statusLine;

        }

    }

    /**

     * This is the regex used to analyze a status line sent by the server and

     * read by the client.  Servers will send messages like: "HTTP/1.1 200 OK" or "HTTP/1.1 500 Internal Server Error"

     */

    static final String statusLinePattern = "^HTTP/(...) (\\d{3}) (.*)$";

    /**

     * Parses a string value of a status line from an HTTP

     * server.  If the input value is null or empty, we'll

     * return a {@link StatusLine} with null-object values

     */

    public static StatusLine extractStatusLine(String value) {

        }

        };

    }

}

Mutations

1.1
Location : search
Killed by : none replaced return value with Collections.emptyList for com/renomad/minum/web/FunctionalTesting$TestResponse::search → SURVIVED Covering tests