Enum Class MarketLocale

java.lang.Object
java.lang.Enum<MarketLocale>
net.ygbstudio.jbrave.api.options.MarketLocale
All Implemented Interfaces:
Serializable, Comparable<MarketLocale>, Constable, BraveAPIConstant, RegionLocaleIdentifier, ProvidedOption, SearchOption

public enum MarketLocale extends Enum<MarketLocale> implements RegionLocaleIdentifier
Enumeration representing a market locale supported by the Brave Search API.

This enumeration implements the RegionLocaleIdentifier interface, providing methods for URL parameter generation.

See Also:
  • Enum Constant Details

  • Method Details

    • values

      public static MarketLocale[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared
    • valueOf

      public static MarketLocale valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null
    • value

      public String value()
      Description copied from interface: BraveAPIConstant
      Returns the value of the constant. Must be implemented by the enum constants.
      Specified by:
      value in interface BraveAPIConstant
      Returns:
      the value of the constant
    • urlParam

      @NotNull public @NotNull String urlParam()
      Description copied from interface: BraveAPIConstant
      Returns the URL parameter associated with this constant. It can be implemented by default at the interface level with the value of the parameter.

      This method is used to generate the URL parameter for the API requests and represents a unit of option/parameterName/parameterConstant + "=" + parameterValue.

      A parameterValue may be provided by the API or require that the client provides it. By default, all options/parameters names are provided by the API.

      Specified by:
      urlParam in interface BraveAPIConstant
      Returns:
      the URL parameter associated with this constant
      See Also:
    • toSearchOption

      @Contract(" -> new") @NotNull public @NotNull @Unmodifiable SearchOptionCarrier<String> toSearchOption()
      Description copied from interface: RegionLocaleIdentifier
      Converts this region locale identifier to a SearchOptionCarrier that can be used to build a URL parameter.
      Specified by:
      toSearchOption in interface ProvidedOption
      Specified by:
      toSearchOption in interface RegionLocaleIdentifier
      Returns:
      a SearchOptionCarrier representing this identifier