All Downloads are FREE. Search and download functionalities are using the official Maven repository.

software.amazon.awssdk.services.waf.model.FieldToMatch Maven / Gradle / Ivy

Go to download

The AWS Java SDK for AWS WAF Service module holds the client classes that are used for communicating with AWS WAF Service

There is a newer version: 2.29.15
Show newest version
/*
 * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
 * the License. A copy of the License is located at
 * 
 * http://aws.amazon.com/apache2.0
 * 
 * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
 * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
 * and limitations under the License.
 */

package software.amazon.awssdk.services.waf.model;

import java.io.Serializable;
import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import java.util.Optional;
import java.util.function.BiConsumer;
import java.util.function.Function;
import software.amazon.awssdk.annotations.Generated;
import software.amazon.awssdk.core.SdkField;
import software.amazon.awssdk.core.SdkPojo;
import software.amazon.awssdk.core.protocol.MarshallLocation;
import software.amazon.awssdk.core.protocol.MarshallingType;
import software.amazon.awssdk.core.traits.LocationTrait;
import software.amazon.awssdk.utils.ToString;
import software.amazon.awssdk.utils.builder.CopyableBuilder;
import software.amazon.awssdk.utils.builder.ToCopyableBuilder;

/**
 * 
 * 

* This is AWS WAF Classic documentation. For more information, see AWS WAF Classic in the * developer guide. *

*

* For the latest version of AWS WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the * latest version, AWS WAF has a single set of endpoints for regional and global use. *

*
*

* Specifies where in a web request to look for TargetString. *

*/ @Generated("software.amazon.awssdk:codegen") public final class FieldToMatch implements SdkPojo, Serializable, ToCopyableBuilder { private static final SdkField TYPE_FIELD = SdkField. builder(MarshallingType.STRING).memberName("Type") .getter(getter(FieldToMatch::typeAsString)).setter(setter(Builder::type)) .traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("Type").build()).build(); private static final SdkField DATA_FIELD = SdkField. builder(MarshallingType.STRING).memberName("Data") .getter(getter(FieldToMatch::data)).setter(setter(Builder::data)) .traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("Data").build()).build(); private static final List> SDK_FIELDS = Collections.unmodifiableList(Arrays.asList(TYPE_FIELD, DATA_FIELD)); private static final Map> SDK_NAME_TO_FIELD = Collections .unmodifiableMap(new HashMap>() { { put("Type", TYPE_FIELD); put("Data", DATA_FIELD); } }); private static final long serialVersionUID = 1L; private final String type; private final String data; private FieldToMatch(BuilderImpl builder) { this.type = builder.type; this.data = builder.data; } /** *

* The part of the web request that you want AWS WAF to search for a specified string. Parts of a request that you * can search include the following: *

*
    *
  • *

    * HEADER: A specified request header, for example, the value of the User-Agent or * Referer header. If you choose HEADER for the type, specify the name of the header in * Data. *

    *
  • *
  • *

    * METHOD: The HTTP method, which indicated the type of operation that the request is asking the origin * to perform. Amazon CloudFront supports the following methods: DELETE, GET, * HEAD, OPTIONS, PATCH, POST, and PUT. *

    *
  • *
  • *

    * QUERY_STRING: A query string, which is the part of a URL that appears after a ? * character, if any. *

    *
  • *
  • *

    * URI: The part of a web request that identifies a resource, for example, * /images/daily-ad.jpg. *

    *
  • *
  • *

    * BODY: The part of a request that contains any additional data that you want to send to your web * server as the HTTP request body, such as data from a form. The request body immediately follows the request * headers. Note that only the first 8192 bytes of the request body are forwarded to AWS WAF for * inspection. To allow or block requests based on the length of the body, you can create a size constraint set. For * more information, see CreateSizeConstraintSet. *

    *
  • *
  • *

    * SINGLE_QUERY_ARG: The parameter in the query string that you will inspect, such as UserName * or SalesRegion. The maximum length for SINGLE_QUERY_ARG is 30 characters. *

    *
  • *
  • *

    * ALL_QUERY_ARGS: Similar to SINGLE_QUERY_ARG, but rather than inspecting a single * parameter, AWS WAF will inspect all parameters within the query for the value or regex pattern that you specify * in TargetString. *

    *
  • *
*

* If the service returns an enum value that is not available in the current SDK version, {@link #type} will return * {@link MatchFieldType#UNKNOWN_TO_SDK_VERSION}. The raw value returned by the service is available from * {@link #typeAsString}. *

* * @return The part of the web request that you want AWS WAF to search for a specified string. Parts of a request * that you can search include the following:

*
    *
  • *

    * HEADER: A specified request header, for example, the value of the User-Agent or * Referer header. If you choose HEADER for the type, specify the name of the * header in Data. *

    *
  • *
  • *

    * METHOD: The HTTP method, which indicated the type of operation that the request is asking * the origin to perform. Amazon CloudFront supports the following methods: DELETE, * GET, HEAD, OPTIONS, PATCH, POST, and * PUT. *

    *
  • *
  • *

    * QUERY_STRING: A query string, which is the part of a URL that appears after a ? * character, if any. *

    *
  • *
  • *

    * URI: The part of a web request that identifies a resource, for example, * /images/daily-ad.jpg. *

    *
  • *
  • *

    * BODY: The part of a request that contains any additional data that you want to send to your * web server as the HTTP request body, such as data from a form. The request body immediately follows the * request headers. Note that only the first 8192 bytes of the request body are forwarded to * AWS WAF for inspection. To allow or block requests based on the length of the body, you can create a size * constraint set. For more information, see CreateSizeConstraintSet. *

    *
  • *
  • *

    * SINGLE_QUERY_ARG: The parameter in the query string that you will inspect, such as * UserName or SalesRegion. The maximum length for SINGLE_QUERY_ARG is 30 * characters. *

    *
  • *
  • *

    * ALL_QUERY_ARGS: Similar to SINGLE_QUERY_ARG, but rather than inspecting a * single parameter, AWS WAF will inspect all parameters within the query for the value or regex pattern * that you specify in TargetString. *

    *
  • * @see MatchFieldType */ public final MatchFieldType type() { return MatchFieldType.fromValue(type); } /** *

    * The part of the web request that you want AWS WAF to search for a specified string. Parts of a request that you * can search include the following: *

    *
      *
    • *

      * HEADER: A specified request header, for example, the value of the User-Agent or * Referer header. If you choose HEADER for the type, specify the name of the header in * Data. *

      *
    • *
    • *

      * METHOD: The HTTP method, which indicated the type of operation that the request is asking the origin * to perform. Amazon CloudFront supports the following methods: DELETE, GET, * HEAD, OPTIONS, PATCH, POST, and PUT. *

      *
    • *
    • *

      * QUERY_STRING: A query string, which is the part of a URL that appears after a ? * character, if any. *

      *
    • *
    • *

      * URI: The part of a web request that identifies a resource, for example, * /images/daily-ad.jpg. *

      *
    • *
    • *

      * BODY: The part of a request that contains any additional data that you want to send to your web * server as the HTTP request body, such as data from a form. The request body immediately follows the request * headers. Note that only the first 8192 bytes of the request body are forwarded to AWS WAF for * inspection. To allow or block requests based on the length of the body, you can create a size constraint set. For * more information, see CreateSizeConstraintSet. *

      *
    • *
    • *

      * SINGLE_QUERY_ARG: The parameter in the query string that you will inspect, such as UserName * or SalesRegion. The maximum length for SINGLE_QUERY_ARG is 30 characters. *

      *
    • *
    • *

      * ALL_QUERY_ARGS: Similar to SINGLE_QUERY_ARG, but rather than inspecting a single * parameter, AWS WAF will inspect all parameters within the query for the value or regex pattern that you specify * in TargetString. *

      *
    • *
    *

    * If the service returns an enum value that is not available in the current SDK version, {@link #type} will return * {@link MatchFieldType#UNKNOWN_TO_SDK_VERSION}. The raw value returned by the service is available from * {@link #typeAsString}. *

    * * @return The part of the web request that you want AWS WAF to search for a specified string. Parts of a request * that you can search include the following:

    *
      *
    • *

      * HEADER: A specified request header, for example, the value of the User-Agent or * Referer header. If you choose HEADER for the type, specify the name of the * header in Data. *

      *
    • *
    • *

      * METHOD: The HTTP method, which indicated the type of operation that the request is asking * the origin to perform. Amazon CloudFront supports the following methods: DELETE, * GET, HEAD, OPTIONS, PATCH, POST, and * PUT. *

      *
    • *
    • *

      * QUERY_STRING: A query string, which is the part of a URL that appears after a ? * character, if any. *

      *
    • *
    • *

      * URI: The part of a web request that identifies a resource, for example, * /images/daily-ad.jpg. *

      *
    • *
    • *

      * BODY: The part of a request that contains any additional data that you want to send to your * web server as the HTTP request body, such as data from a form. The request body immediately follows the * request headers. Note that only the first 8192 bytes of the request body are forwarded to * AWS WAF for inspection. To allow or block requests based on the length of the body, you can create a size * constraint set. For more information, see CreateSizeConstraintSet. *

      *
    • *
    • *

      * SINGLE_QUERY_ARG: The parameter in the query string that you will inspect, such as * UserName or SalesRegion. The maximum length for SINGLE_QUERY_ARG is 30 * characters. *

      *
    • *
    • *

      * ALL_QUERY_ARGS: Similar to SINGLE_QUERY_ARG, but rather than inspecting a * single parameter, AWS WAF will inspect all parameters within the query for the value or regex pattern * that you specify in TargetString. *

      *
    • * @see MatchFieldType */ public final String typeAsString() { return type; } /** *

      * When the value of Type is HEADER, enter the name of the header that you want AWS WAF to * search, for example, User-Agent or Referer. The name of the header is not case * sensitive. *

      *

      * When the value of Type is SINGLE_QUERY_ARG, enter the name of the parameter that you * want AWS WAF to search, for example, UserName or SalesRegion. The parameter name is not * case sensitive. *

      *

      * If the value of Type is any other value, omit Data. *

      * * @return When the value of Type is HEADER, enter the name of the header that you want * AWS WAF to search, for example, User-Agent or Referer. The name of the header * is not case sensitive.

      *

      * When the value of Type is SINGLE_QUERY_ARG, enter the name of the parameter * that you want AWS WAF to search, for example, UserName or SalesRegion. The * parameter name is not case sensitive. *

      *

      * If the value of Type is any other value, omit Data. */ public final String data() { return data; } @Override public Builder toBuilder() { return new BuilderImpl(this); } public static Builder builder() { return new BuilderImpl(); } public static Class serializableBuilderClass() { return BuilderImpl.class; } @Override public final int hashCode() { int hashCode = 1; hashCode = 31 * hashCode + Objects.hashCode(typeAsString()); hashCode = 31 * hashCode + Objects.hashCode(data()); return hashCode; } @Override public final boolean equals(Object obj) { return equalsBySdkFields(obj); } @Override public final boolean equalsBySdkFields(Object obj) { if (this == obj) { return true; } if (obj == null) { return false; } if (!(obj instanceof FieldToMatch)) { return false; } FieldToMatch other = (FieldToMatch) obj; return Objects.equals(typeAsString(), other.typeAsString()) && Objects.equals(data(), other.data()); } /** * Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be * redacted from this string using a placeholder value. */ @Override public final String toString() { return ToString.builder("FieldToMatch").add("Type", typeAsString()).add("Data", data()).build(); } public final Optional getValueForField(String fieldName, Class clazz) { switch (fieldName) { case "Type": return Optional.ofNullable(clazz.cast(typeAsString())); case "Data": return Optional.ofNullable(clazz.cast(data())); default: return Optional.empty(); } } @Override public final List> sdkFields() { return SDK_FIELDS; } @Override public final Map> sdkFieldNameToField() { return SDK_NAME_TO_FIELD; } private static Function getter(Function g) { return obj -> g.apply((FieldToMatch) obj); } private static BiConsumer setter(BiConsumer s) { return (obj, val) -> s.accept((Builder) obj, val); } public interface Builder extends SdkPojo, CopyableBuilder { /** *

      * The part of the web request that you want AWS WAF to search for a specified string. Parts of a request that * you can search include the following: *

      *
        *
      • *

        * HEADER: A specified request header, for example, the value of the User-Agent or * Referer header. If you choose HEADER for the type, specify the name of the header * in Data. *

        *
      • *
      • *

        * METHOD: The HTTP method, which indicated the type of operation that the request is asking the * origin to perform. Amazon CloudFront supports the following methods: DELETE, GET, * HEAD, OPTIONS, PATCH, POST, and PUT. *

        *
      • *
      • *

        * QUERY_STRING: A query string, which is the part of a URL that appears after a ? * character, if any. *

        *
      • *
      • *

        * URI: The part of a web request that identifies a resource, for example, * /images/daily-ad.jpg. *

        *
      • *
      • *

        * BODY: The part of a request that contains any additional data that you want to send to your web * server as the HTTP request body, such as data from a form. The request body immediately follows the request * headers. Note that only the first 8192 bytes of the request body are forwarded to AWS WAF for * inspection. To allow or block requests based on the length of the body, you can create a size constraint set. * For more information, see CreateSizeConstraintSet. *

        *
      • *
      • *

        * SINGLE_QUERY_ARG: The parameter in the query string that you will inspect, such as * UserName or SalesRegion. The maximum length for SINGLE_QUERY_ARG is 30 characters. *

        *
      • *
      • *

        * ALL_QUERY_ARGS: Similar to SINGLE_QUERY_ARG, but rather than inspecting a single * parameter, AWS WAF will inspect all parameters within the query for the value or regex pattern that you * specify in TargetString. *

        *
      • *
      * * @param type * The part of the web request that you want AWS WAF to search for a specified string. Parts of a request * that you can search include the following:

      *
        *
      • *

        * HEADER: A specified request header, for example, the value of the User-Agent * or Referer header. If you choose HEADER for the type, specify the name of * the header in Data. *

        *
      • *
      • *

        * METHOD: The HTTP method, which indicated the type of operation that the request is asking * the origin to perform. Amazon CloudFront supports the following methods: DELETE, * GET, HEAD, OPTIONS, PATCH, POST, and * PUT. *

        *
      • *
      • *

        * QUERY_STRING: A query string, which is the part of a URL that appears after a * ? character, if any. *

        *
      • *
      • *

        * URI: The part of a web request that identifies a resource, for example, * /images/daily-ad.jpg. *

        *
      • *
      • *

        * BODY: The part of a request that contains any additional data that you want to send to * your web server as the HTTP request body, such as data from a form. The request body immediately * follows the request headers. Note that only the first 8192 bytes of the request body are * forwarded to AWS WAF for inspection. To allow or block requests based on the length of the body, you * can create a size constraint set. For more information, see CreateSizeConstraintSet. *

        *
      • *
      • *

        * SINGLE_QUERY_ARG: The parameter in the query string that you will inspect, such as * UserName or SalesRegion. The maximum length for SINGLE_QUERY_ARG is 30 * characters. *

        *
      • *
      • *

        * ALL_QUERY_ARGS: Similar to SINGLE_QUERY_ARG, but rather than inspecting a * single parameter, AWS WAF will inspect all parameters within the query for the value or regex pattern * that you specify in TargetString. *

        *
      • * @see MatchFieldType * @return Returns a reference to this object so that method calls can be chained together. * @see MatchFieldType */ Builder type(String type); /** *

        * The part of the web request that you want AWS WAF to search for a specified string. Parts of a request that * you can search include the following: *

        *
          *
        • *

          * HEADER: A specified request header, for example, the value of the User-Agent or * Referer header. If you choose HEADER for the type, specify the name of the header * in Data. *

          *
        • *
        • *

          * METHOD: The HTTP method, which indicated the type of operation that the request is asking the * origin to perform. Amazon CloudFront supports the following methods: DELETE, GET, * HEAD, OPTIONS, PATCH, POST, and PUT. *

          *
        • *
        • *

          * QUERY_STRING: A query string, which is the part of a URL that appears after a ? * character, if any. *

          *
        • *
        • *

          * URI: The part of a web request that identifies a resource, for example, * /images/daily-ad.jpg. *

          *
        • *
        • *

          * BODY: The part of a request that contains any additional data that you want to send to your web * server as the HTTP request body, such as data from a form. The request body immediately follows the request * headers. Note that only the first 8192 bytes of the request body are forwarded to AWS WAF for * inspection. To allow or block requests based on the length of the body, you can create a size constraint set. * For more information, see CreateSizeConstraintSet. *

          *
        • *
        • *

          * SINGLE_QUERY_ARG: The parameter in the query string that you will inspect, such as * UserName or SalesRegion. The maximum length for SINGLE_QUERY_ARG is 30 characters. *

          *
        • *
        • *

          * ALL_QUERY_ARGS: Similar to SINGLE_QUERY_ARG, but rather than inspecting a single * parameter, AWS WAF will inspect all parameters within the query for the value or regex pattern that you * specify in TargetString. *

          *
        • *
        * * @param type * The part of the web request that you want AWS WAF to search for a specified string. Parts of a request * that you can search include the following:

        *
          *
        • *

          * HEADER: A specified request header, for example, the value of the User-Agent * or Referer header. If you choose HEADER for the type, specify the name of * the header in Data. *

          *
        • *
        • *

          * METHOD: The HTTP method, which indicated the type of operation that the request is asking * the origin to perform. Amazon CloudFront supports the following methods: DELETE, * GET, HEAD, OPTIONS, PATCH, POST, and * PUT. *

          *
        • *
        • *

          * QUERY_STRING: A query string, which is the part of a URL that appears after a * ? character, if any. *

          *
        • *
        • *

          * URI: The part of a web request that identifies a resource, for example, * /images/daily-ad.jpg. *

          *
        • *
        • *

          * BODY: The part of a request that contains any additional data that you want to send to * your web server as the HTTP request body, such as data from a form. The request body immediately * follows the request headers. Note that only the first 8192 bytes of the request body are * forwarded to AWS WAF for inspection. To allow or block requests based on the length of the body, you * can create a size constraint set. For more information, see CreateSizeConstraintSet. *

          *
        • *
        • *

          * SINGLE_QUERY_ARG: The parameter in the query string that you will inspect, such as * UserName or SalesRegion. The maximum length for SINGLE_QUERY_ARG is 30 * characters. *

          *
        • *
        • *

          * ALL_QUERY_ARGS: Similar to SINGLE_QUERY_ARG, but rather than inspecting a * single parameter, AWS WAF will inspect all parameters within the query for the value or regex pattern * that you specify in TargetString. *

          *
        • * @see MatchFieldType * @return Returns a reference to this object so that method calls can be chained together. * @see MatchFieldType */ Builder type(MatchFieldType type); /** *

          * When the value of Type is HEADER, enter the name of the header that you want AWS * WAF to search, for example, User-Agent or Referer. The name of the header is not * case sensitive. *

          *

          * When the value of Type is SINGLE_QUERY_ARG, enter the name of the parameter that * you want AWS WAF to search, for example, UserName or SalesRegion. The parameter * name is not case sensitive. *

          *

          * If the value of Type is any other value, omit Data. *

          * * @param data * When the value of Type is HEADER, enter the name of the header that you want * AWS WAF to search, for example, User-Agent or Referer. The name of the * header is not case sensitive.

          *

          * When the value of Type is SINGLE_QUERY_ARG, enter the name of the parameter * that you want AWS WAF to search, for example, UserName or SalesRegion. The * parameter name is not case sensitive. *

          *

          * If the value of Type is any other value, omit Data. * @return Returns a reference to this object so that method calls can be chained together. */ Builder data(String data); } static final class BuilderImpl implements Builder { private String type; private String data; private BuilderImpl() { } private BuilderImpl(FieldToMatch model) { type(model.type); data(model.data); } public final String getType() { return type; } public final void setType(String type) { this.type = type; } @Override public final Builder type(String type) { this.type = type; return this; } @Override public final Builder type(MatchFieldType type) { this.type(type == null ? null : type.toString()); return this; } public final String getData() { return data; } public final void setData(String data) { this.data = data; } @Override public final Builder data(String data) { this.data = data; return this; } @Override public FieldToMatch build() { return new FieldToMatch(this); } @Override public List> sdkFields() { return SDK_FIELDS; } @Override public Map> sdkFieldNameToField() { return SDK_NAME_TO_FIELD; } } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy