Class Factory

java/core/src/java/org/apache/orc/DataMask.java:117–140

To create a DataMask, the users should come through this API. It supports extension via additional DataMask.Provider implementations that are accessed through Java's ServiceLoader API.

   * that are accessed through Java's ServiceLoader API.
   */
  class Factory {

    /**
     * Build a new DataMask instance.
     * @param mask the description of the data mask
     * @param schema the type of the field
     * @param overrides sub-columns where the mask is overridden
     * @return a new DataMask
     * @throws IllegalArgumentException if no such kind of data mask was found
     *
     * @see org.apache.orc.impl.mask.MaskProvider for the standard provider
     */
    public static DataMask build(DataMaskDescription mask,
                                 TypeDescription schema,
                                 MaskOverrides overrides) {
      for(Provider provider: ServiceLoader.load(Provider.class)) {
        DataMask result = provider.build(mask, schema, overrides);
        if (result != null) {
          return result;
        }
      }
      throw new IllegalArgumentException("Can't find data mask - " + mask);
    }
  }
}