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

org.apache.solr.core.ConfigSetProperties Maven / Gradle / Ivy

There is a newer version: 9.7.0
Show newest version
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License 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 org.apache.solr.core;

import java.io.InputStreamReader;
import java.lang.invoke.MethodHandles;
import java.nio.charset.StandardCharsets;
import java.util.Map;
import org.apache.solr.common.SolrException;
import org.apache.solr.common.SolrException.ErrorCode;
import org.apache.solr.common.util.NamedList;
import org.apache.solr.common.util.Utils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * Utility methods for reading configSet properties. One purpose of this notion is to express
 * immutability. The contents are not used within the config itself; do not confuse this with config
 * user-defined properties. The properties are stored as a JSON file within the configSet that we
 * read into a NamedList. It's optional; there is no file if there are no properties. Note that this
 * logic is also used to load configSet flags; see {@link ConfigSetService}.
 */
public class ConfigSetProperties {

  private static final Logger log = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());

  public static final String DEFAULT_FILENAME = "configsetprops.json";
  public static final String IMMUTABLE_CONFIGSET_ARG = "immutable";

  /**
   * Return the properties associated with the ConfigSet (e.g. immutable)
   *
   * @param loader the resource loader
   * @param name the name of the config set properties file
   * @return the properties in a NamedList
   */
  public static NamedList readFromResourceLoader(SolrResourceLoader loader, String name) {
    try (InputStreamReader reader =
        new InputStreamReader(loader.openResource(name), StandardCharsets.UTF_8)) {
      return readFromInputStream(reader);
    } catch (SolrResourceNotFoundException ex) {
      if (log.isDebugEnabled()) {
        log.debug("Did not find ConfigSet properties, assuming default properties: ", ex);
      }
      return null;
    } catch (Exception ex) {
      throw new SolrException(
          ErrorCode.SERVER_ERROR, "Unable to load reader for ConfigSet properties: " + name, ex);
    }
  }

  public static NamedList readFromInputStream(InputStreamReader reader) {
    try {
      Object object = Utils.fromJSON(reader);
      if (!(object instanceof Map)) {
        final String objectClass = object == null ? "null" : object.getClass().getName();
        throw new SolrException(
            ErrorCode.SERVER_ERROR, "Invalid JSON type " + objectClass + ", expected Map");
      }
      @SuppressWarnings("unchecked")
      Map map = (Map) object;
      return new NamedList<>(map);
    } catch (Exception ex) {
      throw new SolrException(ErrorCode.SERVER_ERROR, "Unable to load ConfigSet properties", ex);
    }
  }
}