Class FileLocator.FileLocatorBuilder

java.lang.Object
org.apache.commons.configuration2.io.FileLocator.FileLocatorBuilder
Enclosing class:
FileLocator

public static final class FileLocator.FileLocatorBuilder extends Object
A typical builder implementation for creating FileLocator objects. An instance of this class is returned by the fileLocator() method of {link FileLocatorUtils}. It can be used to define the various components of the FileLocator object. By calling create() the new immutable FileLocator instance is created.
  • Field Details

    • basePath

      private String basePath
      The base path.
    • encoding

      private String encoding
      The encoding.
    • fileName

      private String fileName
      The file name.
    • fileSystem

      private FileSystem fileSystem
      The file system.
    • locationStrategy

      private FileLocationStrategy locationStrategy
      The location strategy.
    • sourceURL

      private URL sourceURL
      The URL.
    • urlConnectionOptions

      private URLConnectionOptions urlConnectionOptions
      The URL connection options.
  • Constructor Details

    • FileLocatorBuilder

      FileLocatorBuilder(FileLocator src)
      Creates a new instance of FileLocatorBuilder and initializes the builder's properties from the passed in FileLocator object.
      Parameters:
      src - the source FileLocator (may be null)
  • Method Details

    • basePath

      public FileLocator.FileLocatorBuilder basePath(String path)
      Specifies the base path of the new FileLocator.
      Parameters:
      path - the base path
      Returns:
      a reference to this builder for method chaining
    • create

      public FileLocator create()
      Creates a new immutable FileLocatorImpl object based on the properties set so far for this builder.
      Returns:
      the newly created FileLocator object, never null.
    • encoding

      public FileLocator.FileLocatorBuilder encoding(String enc)
      Specifies the encoding of the new FileLocator.
      Parameters:
      enc - the encoding
      Returns:
      a reference to this builder for method chaining
    • fileName

      public FileLocator.FileLocatorBuilder fileName(String name)
      Specifies the file name of the new FileLocator.
      Parameters:
      name - the file name
      Returns:
      a reference to this builder for method chaining
    • fileSystem

      Specifies the FileSystem of the new FileLocator.
      Parameters:
      fs - the FileSystem
      Returns:
      a reference to this builder for method chaining
    • initBuilder

      private void initBuilder(FileLocator src)
      Initializes the properties of this builder from the passed in locator object.
      Parameters:
      src - the source FileLocator
    • locationStrategy

      public FileLocator.FileLocatorBuilder locationStrategy(FileLocationStrategy strategy)
      Specifies the FileLocationStrategy to be used when the referenced file is to be located.
      Parameters:
      strategy - the FileLocationStrategy
      Returns:
      a reference to this builder for method chaining
    • sourceURL

      public FileLocator.FileLocatorBuilder sourceURL(URL url)
      Specifies the source URL of the new FileLocator.
      Parameters:
      url - the source URL
      Returns:
      a reference to this builder for method chaining
    • urlConnectionOptions

      public FileLocator.FileLocatorBuilder urlConnectionOptions(URLConnectionOptions urlConnectionOptions)
      Specifies the source URL connection options of the new FileLocator.
      Parameters:
      urlConnectionOptions - the source URL connection options.
      Returns:
      a reference to this builder for method chaining