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

public.javadoc.org.spincast.plugins.config.SpincastConfigDefault.html Maven / Gradle / Ivy

There is a newer version: 2.2.0
Show newest version






SpincastConfigDefault (org.spincast:spincast-framework 1.14.0 API)












org.spincast.plugins.config

Class SpincastConfigDefault

  • All Implemented Interfaces:
    SpincastConfig
    Direct Known Subclasses:
    SpincastConfigTestingDefault


    public class SpincastConfigDefault
    extends ConfigFinder
    implements SpincastConfig
    If you extend this class (which is recommended to implement your configuration), beware that causing circular dependencies is very easy if you inject more dependencies than SpincastConfigPluginConfig! Indeed, most components depend on the config components.

    Also, don't forget to annotated the testingMode parameter with @TestingMode!

    • Constructor Detail

      • SpincastConfigDefault

        @Inject
        protected SpincastConfigDefault(SpincastConfigPluginConfig spincastConfigPluginConfig,
                                                boolean testingMode)
        Constructor
    • Method Detail

      • init

        @Inject
        protected void init()
      • getEnvironmentName

        public String getEnvironmentName()
        Description copied from interface: SpincastConfig
        Returns the name of the environment. The default value is local.
        Specified by:
        getEnvironmentName in interface SpincastConfig
        Returns:
        the name of the environment
      • getHttpServerPort

        public int getHttpServerPort()
        Description copied from interface: SpincastConfig
        The HTTP (unsecure) port on which the server will listen on. If <= 0, it won't be used. The default value is 44419 so HTTP is enabled by default.
        Specified by:
        getHttpServerPort in interface SpincastConfig
        Returns:
        the HTTP port
      • getHttpsServerPort

        public int getHttpsServerPort()
        Description copied from interface: SpincastConfig
        The HTTPS (secure) port on which the server will listen on. If <= 0, it won't be used. The default value is -1 so HTTPS is not enabled by default.
        Specified by:
        getHttpsServerPort in interface SpincastConfig
        Returns:
        the HTTPS port
      • getHttpsKeyStorePath

        public String getHttpsKeyStorePath()
        Description copied from interface: SpincastConfig
        The path to the KeyStore, for SSL. Can be a classpath path or and absolute path. The classpath will be checked first. Only used if getHttpsServerPort() returns a port > 0. The default value is null.
        Specified by:
        getHttpsKeyStorePath in interface SpincastConfig
        Returns:
        the path to the KeyStore
      • getHttpsKeyStoreType

        public String getHttpsKeyStoreType()
        Description copied from interface: SpincastConfig
        The type of the KeyStore, for SSL. For example: "JKS". Only used if getHttpsServerPort() returns a port > 0. The default value is null.
        Specified by:
        getHttpsKeyStoreType in interface SpincastConfig
        Returns:
        the type of the KeyStore
      • getHttpsKeyStoreStorePass

        public String getHttpsKeyStoreStorePass()
        Description copied from interface: SpincastConfig
        The "storepass" of the KeyStore, for SSL. Only used if getHttpsServerPort() returns a port > 0. The default value is null.
        Specified by:
        getHttpsKeyStoreStorePass in interface SpincastConfig
        Returns:
        the "storepass" of the KeyStore
      • getHttpsKeyStoreKeyPass

        public String getHttpsKeyStoreKeyPass()
        Description copied from interface: SpincastConfig
        The "keypass" of the KeyStore, for SSL. Only used if getHttpsServerPort() returns a port > 0. The default value is null.
        Specified by:
        getHttpsKeyStoreKeyPass in interface SpincastConfig
        Returns:
        the "keypass" of the KeyStore
      • getPublicURI

        protected URI getPublicURI()
      • getHostForDefaultPublicServerSchemeHostPort

        protected String getHostForDefaultPublicServerSchemeHostPort()
      • getServerHost

        public String getServerHost()
        Description copied from interface: SpincastConfig
        The host/IP on which the server will listen to. The default value is 0.0.0.0.
        Specified by:
        getServerHost in interface SpincastConfig
        Returns:
        the host/IP
      • isDevelopmentMode

        public boolean isDevelopmentMode()
        Description copied from interface: SpincastConfig
        Let this to true on a development environment, where errors can be publicly displayed, where cache can be disabled, where class redefinition can be done, etc.

        In production set it to false

        The default value is true.

        Specified by:
        isDevelopmentMode in interface SpincastConfig
        Returns:
        true if debug mode is enabled.
      • isTestingMode

        public boolean isTestingMode()
        Description copied from interface: SpincastConfig
        Returns true if the context has been created for running tests.

        For example, this would by default disable the scheduled tasks to be registered.

        Specified by:
        isTestingMode in interface SpincastConfig
      • getServerMaxRequestBodyBytes

        public long getServerMaxRequestBodyBytes()
        Description copied from interface: SpincastConfig
        Maximum number of bytes a request's body can have. "-1" means no limit. The default value is 104857600 (100MB).
        Specified by:
        getServerMaxRequestBodyBytes in interface SpincastConfig
        Returns:
        the maximum number of bytes
      • isEnableHttp2

        public boolean isEnableHttp2()
        Description copied from interface: SpincastConfig
        Should HTTP/2 be enabled on the embedded Server, if its supports it? Note that Undertow, the default server provided with Spincast, does support it.

        Defaults to true.

        Specified by:
        isEnableHttp2 in interface SpincastConfig
      • getContentTypesToSkipGziping

        public List<String> getContentTypesToSkipGziping()
        Description copied from interface: SpincastConfig
        Even if gziping of the response is enabled, those Content-Types still won't be gzipped. If an entry ends with "*", it will be considered as a prefix (ex: "image/*" will match all Content-Types starting with "image/"). Otherwise, the current response Content-Type will have to exactly match the entry (case insensitive), or being followed by a " " or a ";".
        Specified by:
        getContentTypesToSkipGziping in interface SpincastConfig
        Returns:
        the Content-Types that shouldn't be gzipped.
      • getWritableRootDir

        public File getWritableRootDir()
        Will call getSpincastWritableDirPath() to get the path to use for the writable directory. If this method returns null, a directory will be created under the java.io.tmpdir directory.
        Specified by:
        getWritableRootDir in interface SpincastConfig
        Returns:
        a directory with write permissions for Spincast.
      • getTempDir

        public File getTempDir()
        Description copied from interface: SpincastConfig
        A directory where temp files can be written by Spincast.

        This directory will be emptied each time the application starts!

        Specified by:
        getTempDir in interface SpincastConfig
      • getSpincastWritableDirPath

        protected String getSpincastWritableDirPath()
        The path to the writable directory.

        The path can be relative or absolute.

        Returns:
        the path or null to use the default location (using the "java.io.tmpdir" folder).
      • getDefaultLocale

        public Locale getDefaultLocale()
        Description copied from interface: SpincastConfig
        The default Locale to use if no other Locale can be found as a "best match", for the current request. The default value is Locale.US.
        Specified by:
        getDefaultLocale in interface SpincastConfig
        Returns:
        the default Locale
      • getDefaultTimeZone

        public TimeZone getDefaultTimeZone()
        Description copied from interface: SpincastConfig
        The default TimeZone to use if no other TimeZone can be found as a "best match", for the current request. The default value is UTC.
        Specified by:
        getDefaultTimeZone in interface SpincastConfig
        Returns:
        the default TimeZone
      • getRouteForwardingMaxNumber

        public int getRouteForwardingMaxNumber()
        Description copied from interface: SpincastConfig
        The maximum number of time a request can be forwarded to another route. After this number, an exception will be thrown. The default value is 2.
        Specified by:
        getRouteForwardingMaxNumber in interface SpincastConfig
        Returns:
        the maximum number of time
      • isWriteToDiskDynamicStaticResource

        public boolean isWriteToDiskDynamicStaticResource()
        Description copied from interface: SpincastConfig
        If true, the dynamic resources (static resource which have a generator in case they don't exist) won't be saved to disk. This means that the generator will always be called, so changes during development will be picked up.
        Specified by:
        isWriteToDiskDynamicStaticResource in interface SpincastConfig
      • isAddDefaultTemplateVariablesFilter

        public boolean isAddDefaultTemplateVariablesFilter()
        Description copied from interface: SpincastConfig
        Should the GlobalTemplateVariablesAdderFilter be automatically added to all routes?

        This filter bind some default variables to be used by the templating engine.

        Specified by:
        isAddDefaultTemplateVariablesFilter in interface SpincastConfig
      • getDefaultStaticResourceCacheConfig

        public StaticResourceCacheConfig getDefaultStaticResourceCacheConfig(boolean isDynamicResource)
        Description copied from interface: SpincastConfig
        The default cache configurations for the static resource.

        This will be used if no cache(...) method is used when building the static resource's route.

        Specified by:
        getDefaultStaticResourceCacheConfig in interface SpincastConfig
        Parameters:
        isDynamicResource - if true, a generator is use when the resource doesn't exist. Those kind of generated resources may be modified more often then trully static resources, so we may want to use a different caching period.
        Returns:
        the default cache configuration to use or null so no cache headers are sent at all.
      • getMaxNumberOfKeysWhenConvertingMapToJsonObject

        public int getMaxNumberOfKeysWhenConvertingMapToJsonObject()
        Description copied from interface: SpincastConfig
        Gets the maximum number of keys in a Map that can be parsed as JsonPaths to create a JsonObject.

        This maximum is to prevent malicious user to POST a very big number of keys and harm the server.

        Specified by:
        getMaxNumberOfKeysWhenConvertingMapToJsonObject in interface SpincastConfig
      • getKeyMaxLengthWhenConvertingMapToJsonObject

        public int getKeyMaxLengthWhenConvertingMapToJsonObject()
        Description copied from interface: SpincastConfig
        Gets the maximum length of a key in a Map that can be parsed as JsonPaths using the create method.

        This maximum is to prevent malicious user to POST very long and complex keys and harm the server.

        Specified by:
        getKeyMaxLengthWhenConvertingMapToJsonObject in interface SpincastConfig
      • getJsonPathArrayIndexMax

        public int getJsonPathArrayIndexMax()
        Description copied from interface: SpincastConfig
        Gets the maximum index of an element of an array, when parsing a JsonPath.
        Specified by:
        getJsonPathArrayIndexMax in interface SpincastConfig
      • isEnableCookiesValidator

        public boolean isEnableCookiesValidator()
        Description copied from interface: SpincastConfig
        If true, Spincast will always try to set a cookie to validate if cookies are enabled on the client.

        This is enabled by default

        Specified by:
        isEnableCookiesValidator in interface SpincastConfig
      • getDictionaryEntryNotFoundBehavior

        public DictionaryEntryNotFoundBehavior getDictionaryEntryNotFoundBehavior()
        Description copied from interface: SpincastConfig
        If a dictionary key is not found, how must Spincast react?

        Note that if the key is not found for the current Locale, Spincast will first check if it exists for the fallback Locale (the empty Locale).

        By default, in debug mode an exception is thrown. Otherwise, an empty string is returned but an error is logged.

        Specified by:
        getDictionaryEntryNotFoundBehavior in interface SpincastConfig

Copyright © 2019. All rights reserved.





© 2015 - 2024 Weber Informatics LLC | Privacy Policy