1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474 |
- /*
- * Copyright (C) 2010, Mathias Kinzler <mathias.kinzler@sap.com>
- * Copyright (C) 2009, Constantine Plotnikov <constantine.plotnikov@gmail.com>
- * Copyright (C) 2007, Dave Watson <dwatson@mimvista.com>
- * Copyright (C) 2008-2010, Google Inc.
- * Copyright (C) 2009, Google, Inc.
- * Copyright (C) 2009, JetBrains s.r.o.
- * Copyright (C) 2007-2008, Robin Rosenberg <robin.rosenberg@dewire.com>
- * Copyright (C) 2006-2008, Shawn O. Pearce <spearce@spearce.org>
- * Copyright (C) 2008, Thad Hughes <thadh@thad.corp.google.com>
- * and other copyright owners as documented in the project's IP log.
- *
- * This program and the accompanying materials are made available
- * under the terms of the Eclipse Distribution License v1.0 which
- * accompanies this distribution, is reproduced below, and is
- * available at http://www.eclipse.org/org/documents/edl-v10.php
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or
- * without modification, are permitted provided that the following
- * conditions are met:
- *
- * - Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * - Redistributions in binary form must reproduce the above
- * copyright notice, this list of conditions and the following
- * disclaimer in the documentation and/or other materials provided
- * with the distribution.
- *
- * - Neither the name of the Eclipse Foundation, Inc. nor the
- * names of its contributors may be used to endorse or promote
- * products derived from this software without specific prior
- * written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
- * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
- * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
- * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
- * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
- * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
- * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
- * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
- * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
- * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
- * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-
- package org.eclipse.jgit.lib;
-
- import java.text.MessageFormat;
- import java.util.ArrayList;
- import java.util.Collections;
- import java.util.HashSet;
- import java.util.List;
- import java.util.Map;
- import java.util.Set;
- import java.util.concurrent.ConcurrentHashMap;
- import java.util.concurrent.atomic.AtomicReference;
-
- import org.eclipse.jgit.JGitText;
- import org.eclipse.jgit.errors.ConfigInvalidException;
- import org.eclipse.jgit.events.ConfigChangedEvent;
- import org.eclipse.jgit.events.ConfigChangedListener;
- import org.eclipse.jgit.events.ListenerHandle;
- import org.eclipse.jgit.events.ListenerList;
- import org.eclipse.jgit.util.StringUtils;
-
-
- /**
- * Git style {@code .config}, {@code .gitconfig}, {@code .gitmodules} file.
- */
- public class Config {
- private static final String[] EMPTY_STRING_ARRAY = {};
- private static final long KiB = 1024;
- private static final long MiB = 1024 * KiB;
- private static final long GiB = 1024 * MiB;
-
- /** the change listeners */
- private final ListenerList listeners = new ListenerList();
-
- /**
- * Immutable current state of the configuration data.
- * <p>
- * This state is copy-on-write. It should always contain an immutable list
- * of the configuration keys/values.
- */
- private final AtomicReference<State> state;
-
- private final Config baseConfig;
-
- /**
- * Magic value indicating a missing entry.
- * <p>
- * This value is tested for reference equality in some contexts, so we
- * must ensure it is a special copy of the empty string. It also must
- * be treated like the empty string.
- */
- private static final String MAGIC_EMPTY_VALUE = new String();
-
- /** Create a configuration with no default fallback. */
- public Config() {
- this(null);
- }
-
- /**
- * Create an empty configuration with a fallback for missing keys.
- *
- * @param defaultConfig
- * the base configuration to be consulted when a key is missing
- * from this configuration instance.
- */
- public Config(Config defaultConfig) {
- baseConfig = defaultConfig;
- state = new AtomicReference<State>(newState());
- }
-
- /**
- * Escape the value before saving
- *
- * @param x
- * the value to escape
- * @return the escaped value
- */
- private static String escapeValue(final String x) {
- boolean inquote = false;
- int lineStart = 0;
- final StringBuilder r = new StringBuilder(x.length());
- for (int k = 0; k < x.length(); k++) {
- final char c = x.charAt(k);
- switch (c) {
- case '\n':
- if (inquote) {
- r.append('"');
- inquote = false;
- }
- r.append("\\n\\\n");
- lineStart = r.length();
- break;
-
- case '\t':
- r.append("\\t");
- break;
-
- case '\b':
- r.append("\\b");
- break;
-
- case '\\':
- r.append("\\\\");
- break;
-
- case '"':
- r.append("\\\"");
- break;
-
- case ';':
- case '#':
- if (!inquote) {
- r.insert(lineStart, '"');
- inquote = true;
- }
- r.append(c);
- break;
-
- case ' ':
- if (!inquote && r.length() > 0
- && r.charAt(r.length() - 1) == ' ') {
- r.insert(lineStart, '"');
- inquote = true;
- }
- r.append(' ');
- break;
-
- default:
- r.append(c);
- break;
- }
- }
- if (inquote) {
- r.append('"');
- }
- return r.toString();
- }
-
- /**
- * Obtain an integer value from the configuration.
- *
- * @param section
- * section the key is grouped within.
- * @param name
- * name of the key to get.
- * @param defaultValue
- * default value to return if no value was present.
- * @return an integer value from the configuration, or defaultValue.
- */
- public int getInt(final String section, final String name,
- final int defaultValue) {
- return getInt(section, null, name, defaultValue);
- }
-
- /**
- * Obtain an integer value from the configuration.
- *
- * @param section
- * section the key is grouped within.
- * @param subsection
- * subsection name, such a remote or branch name.
- * @param name
- * name of the key to get.
- * @param defaultValue
- * default value to return if no value was present.
- * @return an integer value from the configuration, or defaultValue.
- */
- public int getInt(final String section, String subsection,
- final String name, final int defaultValue) {
- final long val = getLong(section, subsection, name, defaultValue);
- if (Integer.MIN_VALUE <= val && val <= Integer.MAX_VALUE)
- return (int) val;
- throw new IllegalArgumentException(MessageFormat.format(JGitText.get().integerValueOutOfRange
- , section, name));
- }
-
- /**
- * Obtain an integer value from the configuration.
- *
- * @param section
- * section the key is grouped within.
- * @param name
- * name of the key to get.
- * @param defaultValue
- * default value to return if no value was present.
- * @return an integer value from the configuration, or defaultValue.
- */
- public long getLong(String section, String name, long defaultValue) {
- return getLong(section, null, name, defaultValue);
- }
-
- /**
- * Obtain an integer value from the configuration.
- *
- * @param section
- * section the key is grouped within.
- * @param subsection
- * subsection name, such a remote or branch name.
- * @param name
- * name of the key to get.
- * @param defaultValue
- * default value to return if no value was present.
- * @return an integer value from the configuration, or defaultValue.
- */
- public long getLong(final String section, String subsection,
- final String name, final long defaultValue) {
- final String str = getString(section, subsection, name);
- if (str == null)
- return defaultValue;
-
- String n = str.trim();
- if (n.length() == 0)
- return defaultValue;
-
- long mul = 1;
- switch (StringUtils.toLowerCase(n.charAt(n.length() - 1))) {
- case 'g':
- mul = GiB;
- break;
- case 'm':
- mul = MiB;
- break;
- case 'k':
- mul = KiB;
- break;
- }
- if (mul > 1)
- n = n.substring(0, n.length() - 1).trim();
- if (n.length() == 0)
- return defaultValue;
-
- try {
- return mul * Long.parseLong(n);
- } catch (NumberFormatException nfe) {
- throw new IllegalArgumentException(MessageFormat.format(JGitText.get().invalidIntegerValue
- , section, name, str));
- }
- }
-
- /**
- * Get a boolean value from the git config
- *
- * @param section
- * section the key is grouped within.
- * @param name
- * name of the key to get.
- * @param defaultValue
- * default value to return if no value was present.
- * @return true if any value or defaultValue is true, false for missing or
- * explicit false
- */
- public boolean getBoolean(final String section, final String name,
- final boolean defaultValue) {
- return getBoolean(section, null, name, defaultValue);
- }
-
- /**
- * Get a boolean value from the git config
- *
- * @param section
- * section the key is grouped within.
- * @param subsection
- * subsection name, such a remote or branch name.
- * @param name
- * name of the key to get.
- * @param defaultValue
- * default value to return if no value was present.
- * @return true if any value or defaultValue is true, false for missing or
- * explicit false
- */
- public boolean getBoolean(final String section, String subsection,
- final String name, final boolean defaultValue) {
- String n = getRawString(section, subsection, name);
- if (n == null)
- return defaultValue;
- if (MAGIC_EMPTY_VALUE == n)
- return true;
- try {
- return StringUtils.toBoolean(n);
- } catch (IllegalArgumentException err) {
- throw new IllegalArgumentException(MessageFormat.format(JGitText.get().invalidBooleanValue
- , section, name, n));
- }
- }
-
- /**
- * Parse an enumeration from the configuration.
- *
- * @param <T>
- * type of the enumeration object.
- * @param section
- * section the key is grouped within.
- * @param subsection
- * subsection name, such a remote or branch name.
- * @param name
- * name of the key to get.
- * @param defaultValue
- * default value to return if no value was present.
- * @return the selected enumeration value, or {@code defaultValue}.
- */
- public <T extends Enum<?>> T getEnum(final String section,
- final String subsection, final String name, final T defaultValue) {
- final T[] all = allValuesOf(defaultValue);
- return getEnum(all, section, subsection, name, defaultValue);
- }
-
- @SuppressWarnings("unchecked")
- private static <T> T[] allValuesOf(final T value) {
- try {
- return (T[]) value.getClass().getMethod("values").invoke(null);
- } catch (Exception err) {
- String typeName = value.getClass().getName();
- String msg = MessageFormat.format(
- JGitText.get().enumValuesNotAvailable, typeName);
- throw new IllegalArgumentException(msg, err);
- }
- }
-
- /**
- * Parse an enumeration from the configuration.
- *
- * @param <T>
- * type of the enumeration object.
- * @param all
- * all possible values in the enumeration which should be
- * recognized. Typically {@code EnumType.values()}.
- * @param section
- * section the key is grouped within.
- * @param subsection
- * subsection name, such a remote or branch name.
- * @param name
- * name of the key to get.
- * @param defaultValue
- * default value to return if no value was present.
- * @return the selected enumeration value, or {@code defaultValue}.
- */
- public <T extends Enum<?>> T getEnum(final T[] all, final String section,
- final String subsection, final String name, final T defaultValue) {
- String value = getString(section, subsection, name);
- if (value == null)
- return defaultValue;
-
- String n = value.replace(' ', '_');
- T trueState = null;
- T falseState = null;
- for (T e : all) {
- if (StringUtils.equalsIgnoreCase(e.name(), n))
- return e;
- else if (StringUtils.equalsIgnoreCase(e.name(), "TRUE"))
- trueState = e;
- else if (StringUtils.equalsIgnoreCase(e.name(), "FALSE"))
- falseState = e;
- }
-
- // This is an odd little fallback. C Git sometimes allows boolean
- // values in a tri-state with other things. If we have both a true
- // and a false value in our enumeration, assume its one of those.
- //
- if (trueState != null && falseState != null) {
- try {
- return StringUtils.toBoolean(n) ? trueState : falseState;
- } catch (IllegalArgumentException err) {
- // Fall through and use our custom error below.
- }
- }
-
- if (subsection != null)
- throw new IllegalArgumentException(MessageFormat.format(JGitText
- .get().enumValueNotSupported3, section, name, value));
- else
- throw new IllegalArgumentException(MessageFormat.format(JGitText
- .get().enumValueNotSupported2, section, name, value));
- }
-
- /**
- * Get string value
- *
- * @param section
- * the section
- * @param subsection
- * the subsection for the value
- * @param name
- * the key name
- * @return a String value from git config.
- */
- public String getString(final String section, String subsection,
- final String name) {
- return getRawString(section, subsection, name);
- }
-
- /**
- * Get a list of string values
- * <p>
- * If this instance was created with a base, the base's values are returned
- * first (if any).
- *
- * @param section
- * the section
- * @param subsection
- * the subsection for the value
- * @param name
- * the key name
- * @return array of zero or more values from the configuration.
- */
- public String[] getStringList(final String section, String subsection,
- final String name) {
- final String[] baseList;
- if (baseConfig != null)
- baseList = baseConfig.getStringList(section, subsection, name);
- else
- baseList = EMPTY_STRING_ARRAY;
-
- final List<String> lst = getRawStringList(section, subsection, name);
- if (lst != null) {
- final String[] res = new String[baseList.length + lst.size()];
- int idx = baseList.length;
- System.arraycopy(baseList, 0, res, 0, idx);
- for (final String val : lst)
- res[idx++] = val;
- return res;
- }
- return baseList;
- }
-
- /**
- * @param section
- * section to search for.
- * @return set of all subsections of specified section within this
- * configuration and its base configuration; may be empty if no
- * subsection exists.
- */
- public Set<String> getSubsections(final String section) {
- return get(new SubsectionNames(section));
- }
-
- /**
- * @return the sections defined in this {@link Config}
- */
- public Set<String> getSections() {
- return get(new SectionNames());
- }
-
- /**
- * @param section
- * the section
- * @return the list of names defined for this section
- */
- public Set<String> getNames(String section) {
- return getNames(section, null);
- }
-
- /**
- * @param section
- * the section
- * @param subsection
- * the subsection
- * @return the list of names defined for this subsection
- */
- public Set<String> getNames(String section, String subsection) {
- return get(new NamesInSection(section, subsection));
- }
-
- /**
- * Obtain a handle to a parsed set of configuration values.
- *
- * @param <T>
- * type of configuration model to return.
- * @param parser
- * parser which can create the model if it is not already
- * available in this configuration file. The parser is also used
- * as the key into a cache and must obey the hashCode and equals
- * contract in order to reuse a parsed model.
- * @return the parsed object instance, which is cached inside this config.
- */
- @SuppressWarnings("unchecked")
- public <T> T get(final SectionParser<T> parser) {
- final State myState = getState();
- T obj = (T) myState.cache.get(parser);
- if (obj == null) {
- obj = parser.parse(this);
- myState.cache.put(parser, obj);
- }
- return obj;
- }
-
- /**
- * Remove a cached configuration object.
- * <p>
- * If the associated configuration object has not yet been cached, this
- * method has no effect.
- *
- * @param parser
- * parser used to obtain the configuration object.
- * @see #get(SectionParser)
- */
- public void uncache(final SectionParser<?> parser) {
- state.get().cache.remove(parser);
- }
-
- /**
- * Adds a listener to be notified about changes.
- * <p>
- * Clients are supposed to remove the listeners after they are done with
- * them using the {@link ListenerHandle#remove()} method
- *
- * @param listener
- * the listener
- * @return the handle to the registered listener
- */
- public ListenerHandle addChangeListener(ConfigChangedListener listener) {
- return listeners.addConfigChangedListener(listener);
- }
-
- /**
- * Determine whether to issue change events for transient changes.
- * <p>
- * If <code>true</code> is returned (which is the default behavior),
- * {@link #fireConfigChangedEvent()} will be called upon each change.
- * <p>
- * Subclasses that override this to return <code>false</code> are
- * responsible for issuing {@link #fireConfigChangedEvent()} calls
- * themselves.
- *
- * @return <code></code>
- */
- protected boolean notifyUponTransientChanges() {
- return true;
- }
-
- /**
- * Notifies the listeners
- */
- protected void fireConfigChangedEvent() {
- listeners.dispatch(new ConfigChangedEvent());
- }
-
- private String getRawString(final String section, final String subsection,
- final String name) {
- final List<String> lst = getRawStringList(section, subsection, name);
- if (lst != null)
- return lst.get(0);
- else if (baseConfig != null)
- return baseConfig.getRawString(section, subsection, name);
- else
- return null;
- }
-
- private List<String> getRawStringList(final String section,
- final String subsection, final String name) {
- List<String> r = null;
- for (final Entry e : state.get().entryList) {
- if (e.match(section, subsection, name))
- r = add(r, e.value);
- }
- return r;
- }
-
- private static List<String> add(final List<String> curr, final String value) {
- if (curr == null)
- return Collections.singletonList(value);
- if (curr.size() == 1) {
- final List<String> r = new ArrayList<String>(2);
- r.add(curr.get(0));
- r.add(value);
- return r;
- }
- curr.add(value);
- return curr;
- }
-
- private State getState() {
- State cur, upd;
- do {
- cur = state.get();
- final State base = getBaseState();
- if (cur.baseState == base)
- return cur;
- upd = new State(cur.entryList, base);
- } while (!state.compareAndSet(cur, upd));
- return upd;
- }
-
- private State getBaseState() {
- return baseConfig != null ? baseConfig.getState() : null;
- }
-
- /**
- * Add or modify a configuration value. The parameters will result in a
- * configuration entry like this.
- *
- * <pre>
- * [section "subsection"]
- * name = value
- * </pre>
- *
- * @param section
- * section name, e.g "branch"
- * @param subsection
- * optional subsection value, e.g. a branch name
- * @param name
- * parameter name, e.g. "filemode"
- * @param value
- * parameter value
- */
- public void setInt(final String section, final String subsection,
- final String name, final int value) {
- setLong(section, subsection, name, value);
- }
-
- /**
- * Add or modify a configuration value. The parameters will result in a
- * configuration entry like this.
- *
- * <pre>
- * [section "subsection"]
- * name = value
- * </pre>
- *
- * @param section
- * section name, e.g "branch"
- * @param subsection
- * optional subsection value, e.g. a branch name
- * @param name
- * parameter name, e.g. "filemode"
- * @param value
- * parameter value
- */
- public void setLong(final String section, final String subsection,
- final String name, final long value) {
- final String s;
-
- if (value >= GiB && (value % GiB) == 0)
- s = String.valueOf(value / GiB) + " g";
- else if (value >= MiB && (value % MiB) == 0)
- s = String.valueOf(value / MiB) + " m";
- else if (value >= KiB && (value % KiB) == 0)
- s = String.valueOf(value / KiB) + " k";
- else
- s = String.valueOf(value);
-
- setString(section, subsection, name, s);
- }
-
- /**
- * Add or modify a configuration value. The parameters will result in a
- * configuration entry like this.
- *
- * <pre>
- * [section "subsection"]
- * name = value
- * </pre>
- *
- * @param section
- * section name, e.g "branch"
- * @param subsection
- * optional subsection value, e.g. a branch name
- * @param name
- * parameter name, e.g. "filemode"
- * @param value
- * parameter value
- */
- public void setBoolean(final String section, final String subsection,
- final String name, final boolean value) {
- setString(section, subsection, name, value ? "true" : "false");
- }
-
- /**
- * Add or modify a configuration value. The parameters will result in a
- * configuration entry like this.
- *
- * <pre>
- * [section "subsection"]
- * name = value
- * </pre>
- *
- * @param <T>
- * type of the enumeration object.
- * @param section
- * section name, e.g "branch"
- * @param subsection
- * optional subsection value, e.g. a branch name
- * @param name
- * parameter name, e.g. "filemode"
- * @param value
- * parameter value
- */
- public <T extends Enum<?>> void setEnum(final String section,
- final String subsection, final String name, final T value) {
- String n = value.name().toLowerCase().replace('_', ' ');
- setString(section, subsection, name, n);
- }
-
- /**
- * Add or modify a configuration value. The parameters will result in a
- * configuration entry like this.
- *
- * <pre>
- * [section "subsection"]
- * name = value
- * </pre>
- *
- * @param section
- * section name, e.g "branch"
- * @param subsection
- * optional subsection value, e.g. a branch name
- * @param name
- * parameter name, e.g. "filemode"
- * @param value
- * parameter value, e.g. "true"
- */
- public void setString(final String section, final String subsection,
- final String name, final String value) {
- setStringList(section, subsection, name, Collections
- .singletonList(value));
- }
-
- /**
- * Remove a configuration value.
- *
- * @param section
- * section name, e.g "branch"
- * @param subsection
- * optional subsection value, e.g. a branch name
- * @param name
- * parameter name, e.g. "filemode"
- */
- public void unset(final String section, final String subsection,
- final String name) {
- setStringList(section, subsection, name, Collections
- .<String> emptyList());
- }
-
- /**
- * Remove all configuration values under a single section.
- *
- * @param section
- * section name, e.g "branch"
- * @param subsection
- * optional subsection value, e.g. a branch name
- */
- public void unsetSection(String section, String subsection) {
- State src, res;
- do {
- src = state.get();
- res = unsetSection(src, section, subsection);
- } while (!state.compareAndSet(src, res));
- }
-
- private State unsetSection(final State srcState, final String section,
- final String subsection) {
- final int max = srcState.entryList.size();
- final ArrayList<Entry> r = new ArrayList<Entry>(max);
-
- boolean lastWasMatch = false;
- for (Entry e : srcState.entryList) {
- if (e.match(section, subsection)) {
- // Skip this record, it's for the section we are removing.
- lastWasMatch = true;
- continue;
- }
-
- if (lastWasMatch && e.section == null && e.subsection == null)
- continue; // skip this padding line in the section.
- r.add(e);
- }
-
- return newState(r);
- }
-
- /**
- * Set a configuration value.
- *
- * <pre>
- * [section "subsection"]
- * name = value
- * </pre>
- *
- * @param section
- * section name, e.g "branch"
- * @param subsection
- * optional subsection value, e.g. a branch name
- * @param name
- * parameter name, e.g. "filemode"
- * @param values
- * list of zero or more values for this key.
- */
- public void setStringList(final String section, final String subsection,
- final String name, final List<String> values) {
- State src, res;
- do {
- src = state.get();
- res = replaceStringList(src, section, subsection, name, values);
- } while (!state.compareAndSet(src, res));
- if (notifyUponTransientChanges())
- fireConfigChangedEvent();
- }
-
- private State replaceStringList(final State srcState,
- final String section, final String subsection, final String name,
- final List<String> values) {
- final List<Entry> entries = copy(srcState, values);
- int entryIndex = 0;
- int valueIndex = 0;
- int insertPosition = -1;
-
- // Reset the first n Entry objects that match this input name.
- //
- while (entryIndex < entries.size() && valueIndex < values.size()) {
- final Entry e = entries.get(entryIndex);
- if (e.match(section, subsection, name)) {
- entries.set(entryIndex, e.forValue(values.get(valueIndex++)));
- insertPosition = entryIndex + 1;
- }
- entryIndex++;
- }
-
- // Remove any extra Entry objects that we no longer need.
- //
- if (valueIndex == values.size() && entryIndex < entries.size()) {
- while (entryIndex < entries.size()) {
- final Entry e = entries.get(entryIndex++);
- if (e.match(section, subsection, name))
- entries.remove(--entryIndex);
- }
- }
-
- // Insert new Entry objects for additional/new values.
- //
- if (valueIndex < values.size() && entryIndex == entries.size()) {
- if (insertPosition < 0) {
- // We didn't find a matching key above, but maybe there
- // is already a section available that matches. Insert
- // after the last key of that section.
- //
- insertPosition = findSectionEnd(entries, section, subsection);
- }
- if (insertPosition < 0) {
- // We didn't find any matching section header for this key,
- // so we must create a new section header at the end.
- //
- final Entry e = new Entry();
- e.section = section;
- e.subsection = subsection;
- entries.add(e);
- insertPosition = entries.size();
- }
- while (valueIndex < values.size()) {
- final Entry e = new Entry();
- e.section = section;
- e.subsection = subsection;
- e.name = name;
- e.value = values.get(valueIndex++);
- entries.add(insertPosition++, e);
- }
- }
-
- return newState(entries);
- }
-
- private static List<Entry> copy(final State src, final List<String> values) {
- // At worst we need to insert 1 line for each value, plus 1 line
- // for a new section header. Assume that and allocate the space.
- //
- final int max = src.entryList.size() + values.size() + 1;
- final ArrayList<Entry> r = new ArrayList<Entry>(max);
- r.addAll(src.entryList);
- return r;
- }
-
- private static int findSectionEnd(final List<Entry> entries,
- final String section, final String subsection) {
- for (int i = 0; i < entries.size(); i++) {
- Entry e = entries.get(i);
- if (e.match(section, subsection, null)) {
- i++;
- while (i < entries.size()) {
- e = entries.get(i);
- if (e.match(section, subsection, e.name))
- i++;
- else
- break;
- }
- return i;
- }
- }
- return -1;
- }
-
- /**
- * @return this configuration, formatted as a Git style text file.
- */
- public String toText() {
- final StringBuilder out = new StringBuilder();
- for (final Entry e : state.get().entryList) {
- if (e.prefix != null)
- out.append(e.prefix);
- if (e.section != null && e.name == null) {
- out.append('[');
- out.append(e.section);
- if (e.subsection != null) {
- out.append(' ');
- String escaped = escapeValue(e.subsection);
- // make sure to avoid double quotes here
- boolean quoted = escaped.startsWith("\"")
- && escaped.endsWith("\"");
- if (!quoted)
- out.append('"');
- out.append(escaped);
- if (!quoted)
- out.append('"');
- }
- out.append(']');
- } else if (e.section != null && e.name != null) {
- if (e.prefix == null || "".equals(e.prefix))
- out.append('\t');
- out.append(e.name);
- if (MAGIC_EMPTY_VALUE != e.value) {
- out.append(" =");
- if (e.value != null) {
- out.append(' ');
- out.append(escapeValue(e.value));
- }
- }
- if (e.suffix != null)
- out.append(' ');
- }
- if (e.suffix != null)
- out.append(e.suffix);
- out.append('\n');
- }
- return out.toString();
- }
-
- /**
- * Clear this configuration and reset to the contents of the parsed string.
- *
- * @param text
- * Git style text file listing configuration properties.
- * @throws ConfigInvalidException
- * the text supplied is not formatted correctly. No changes were
- * made to {@code this}.
- */
- public void fromText(final String text) throws ConfigInvalidException {
- final List<Entry> newEntries = new ArrayList<Entry>();
- final StringReader in = new StringReader(text);
- Entry last = null;
- Entry e = new Entry();
- for (;;) {
- int input = in.read();
- if (-1 == input)
- break;
-
- final char c = (char) input;
- if ('\n' == c) {
- // End of this entry.
- newEntries.add(e);
- if (e.section != null)
- last = e;
- e = new Entry();
-
- } else if (e.suffix != null) {
- // Everything up until the end-of-line is in the suffix.
- e.suffix += c;
-
- } else if (';' == c || '#' == c) {
- // The rest of this line is a comment; put into suffix.
- e.suffix = String.valueOf(c);
-
- } else if (e.section == null && Character.isWhitespace(c)) {
- // Save the leading whitespace (if any).
- if (e.prefix == null)
- e.prefix = "";
- e.prefix += c;
-
- } else if ('[' == c) {
- // This is a section header.
- e.section = readSectionName(in);
- input = in.read();
- if ('"' == input) {
- e.subsection = readValue(in, true, '"');
- input = in.read();
- }
- if (']' != input)
- throw new ConfigInvalidException(JGitText.get().badGroupHeader);
- e.suffix = "";
-
- } else if (last != null) {
- // Read a value.
- e.section = last.section;
- e.subsection = last.subsection;
- in.reset();
- e.name = readKeyName(in);
- if (e.name.endsWith("\n")) {
- e.name = e.name.substring(0, e.name.length() - 1);
- e.value = MAGIC_EMPTY_VALUE;
- } else
- e.value = readValue(in, false, -1);
-
- } else
- throw new ConfigInvalidException(JGitText.get().invalidLineInConfigFile);
- }
-
- state.set(newState(newEntries));
- }
-
- private State newState() {
- return new State(Collections.<Entry> emptyList(), getBaseState());
- }
-
- private State newState(final List<Entry> entries) {
- return new State(Collections.unmodifiableList(entries), getBaseState());
- }
-
- /**
- * Clear the configuration file
- */
- protected void clear() {
- state.set(newState());
- }
-
- private static String readSectionName(final StringReader in)
- throws ConfigInvalidException {
- final StringBuilder name = new StringBuilder();
- for (;;) {
- int c = in.read();
- if (c < 0)
- throw new ConfigInvalidException(JGitText.get().unexpectedEndOfConfigFile);
-
- if (']' == c) {
- in.reset();
- break;
- }
-
- if (' ' == c || '\t' == c) {
- for (;;) {
- c = in.read();
- if (c < 0)
- throw new ConfigInvalidException(JGitText.get().unexpectedEndOfConfigFile);
-
- if ('"' == c) {
- in.reset();
- break;
- }
-
- if (' ' == c || '\t' == c)
- continue; // Skipped...
- throw new ConfigInvalidException(MessageFormat.format(JGitText.get().badSectionEntry, name));
- }
- break;
- }
-
- if (Character.isLetterOrDigit((char) c) || '.' == c || '-' == c)
- name.append((char) c);
- else
- throw new ConfigInvalidException(MessageFormat.format(JGitText.get().badSectionEntry, name));
- }
- return name.toString();
- }
-
- private static String readKeyName(final StringReader in)
- throws ConfigInvalidException {
- final StringBuilder name = new StringBuilder();
- for (;;) {
- int c = in.read();
- if (c < 0)
- throw new ConfigInvalidException(JGitText.get().unexpectedEndOfConfigFile);
-
- if ('=' == c)
- break;
-
- if (' ' == c || '\t' == c) {
- for (;;) {
- c = in.read();
- if (c < 0)
- throw new ConfigInvalidException(JGitText.get().unexpectedEndOfConfigFile);
-
- if ('=' == c)
- break;
-
- if (';' == c || '#' == c || '\n' == c) {
- in.reset();
- break;
- }
-
- if (' ' == c || '\t' == c)
- continue; // Skipped...
- throw new ConfigInvalidException(JGitText.get().badEntryDelimiter);
- }
- break;
- }
-
- if (Character.isLetterOrDigit((char) c) || c == '-') {
- // From the git-config man page:
- // The variable names are case-insensitive and only
- // alphanumeric characters and - are allowed.
- name.append((char) c);
- } else if ('\n' == c) {
- in.reset();
- name.append((char) c);
- break;
- } else
- throw new ConfigInvalidException(MessageFormat.format(JGitText.get().badEntryName, name));
- }
- return name.toString();
- }
-
- private static String readValue(final StringReader in, boolean quote,
- final int eol) throws ConfigInvalidException {
- final StringBuilder value = new StringBuilder();
- boolean space = false;
- for (;;) {
- int c = in.read();
- if (c < 0) {
- if (value.length() == 0)
- throw new ConfigInvalidException(JGitText.get().unexpectedEndOfConfigFile);
- break;
- }
-
- if ('\n' == c) {
- if (quote)
- throw new ConfigInvalidException(JGitText.get().newlineInQuotesNotAllowed);
- in.reset();
- break;
- }
-
- if (eol == c)
- break;
-
- if (!quote) {
- if (Character.isWhitespace((char) c)) {
- space = true;
- continue;
- }
- if (';' == c || '#' == c) {
- in.reset();
- break;
- }
- }
-
- if (space) {
- if (value.length() > 0)
- value.append(' ');
- space = false;
- }
-
- if ('\\' == c) {
- c = in.read();
- switch (c) {
- case -1:
- throw new ConfigInvalidException(JGitText.get().endOfFileInEscape);
- case '\n':
- continue;
- case 't':
- value.append('\t');
- continue;
- case 'b':
- value.append('\b');
- continue;
- case 'n':
- value.append('\n');
- continue;
- case '\\':
- value.append('\\');
- continue;
- case '"':
- value.append('"');
- continue;
- default:
- throw new ConfigInvalidException(MessageFormat.format(JGitText.get().badEscape, ((char) c)));
- }
- }
-
- if ('"' == c) {
- quote = !quote;
- continue;
- }
-
- value.append((char) c);
- }
- return value.length() > 0 ? value.toString() : null;
- }
-
- /**
- * Parses a section of the configuration into an application model object.
- * <p>
- * Instances must implement hashCode and equals such that model objects can
- * be cached by using the {@code SectionParser} as a key of a HashMap.
- * <p>
- * As the {@code SectionParser} itself is used as the key of the internal
- * HashMap applications should be careful to ensure the SectionParser key
- * does not retain unnecessary application state which may cause memory to
- * be held longer than expected.
- *
- * @param <T>
- * type of the application model created by the parser.
- */
- public static interface SectionParser<T> {
- /**
- * Create a model object from a configuration.
- *
- * @param cfg
- * the configuration to read values from.
- * @return the application model instance.
- */
- T parse(Config cfg);
- }
-
- private static class SubsectionNames implements SectionParser<Set<String>> {
- private final String section;
-
- SubsectionNames(final String sectionName) {
- section = sectionName;
- }
-
- public int hashCode() {
- return section.hashCode();
- }
-
- public boolean equals(Object other) {
- if (other instanceof SubsectionNames) {
- return section.equals(((SubsectionNames) other).section);
- }
- return false;
- }
-
- public Set<String> parse(Config cfg) {
- final Set<String> result = new HashSet<String>();
- while (cfg != null) {
- for (final Entry e : cfg.state.get().entryList) {
- if (e.subsection != null && e.name == null
- && StringUtils.equalsIgnoreCase(section, e.section))
- result.add(e.subsection);
- }
- cfg = cfg.baseConfig;
- }
- return Collections.unmodifiableSet(result);
- }
- }
-
- private static class NamesInSection implements SectionParser<Set<String>> {
- private final String section;
-
- private final String subsection;
-
- NamesInSection(final String sectionName, final String subSectionName) {
- section = sectionName;
- subsection = subSectionName;
- }
-
- @Override
- public int hashCode() {
- final int prime = 31;
- int result = 1;
- result = prime * result + section.hashCode();
- result = prime * result
- + ((subsection == null) ? 0 : subsection.hashCode());
- return result;
- }
-
- @Override
- public boolean equals(Object obj) {
- if (this == obj)
- return true;
- if (obj == null)
- return false;
- if (getClass() != obj.getClass())
- return false;
- NamesInSection other = (NamesInSection) obj;
- if (!section.equals(other.section))
- return false;
- if (subsection == null) {
- if (other.subsection != null)
- return false;
- } else if (!subsection.equals(other.subsection))
- return false;
- return true;
- }
-
- public Set<String> parse(Config cfg) {
- final Set<String> result = new HashSet<String>();
- while (cfg != null) {
- for (final Entry e : cfg.state.get().entryList) {
- if (e.name != null
- && StringUtils.equalsIgnoreCase(e.section, section)) {
- if (subsection == null && e.subsection == null)
- result.add(StringUtils.toLowerCase(e.name));
- else if (e.subsection != null
- && e.subsection.equals(subsection))
- result.add(StringUtils.toLowerCase(e.name));
-
- }
- }
- cfg = cfg.baseConfig;
- }
- return Collections.unmodifiableSet(result);
- }
- }
-
- private static class SectionNames implements SectionParser<Set<String>> {
- public Set<String> parse(Config cfg) {
- final Set<String> result = new HashSet<String>();
- while (cfg != null) {
- for (final Entry e : cfg.state.get().entryList) {
- if (e.section != null)
- result.add(StringUtils.toLowerCase(e.section));
- }
- cfg = cfg.baseConfig;
- }
- return Collections.unmodifiableSet(result);
- }
- }
-
-
- private static class State {
- final List<Entry> entryList;
-
- final Map<Object, Object> cache;
-
- final State baseState;
-
- State(List<Entry> entries, State base) {
- entryList = entries;
- cache = new ConcurrentHashMap<Object, Object>(16, 0.75f, 1);
- baseState = base;
- }
- }
-
- /**
- * The configuration file entry
- */
- private static class Entry {
- /**
- * The text content before entry
- */
- String prefix;
-
- /**
- * The section name for the entry
- */
- String section;
-
- /**
- * Subsection name
- */
- String subsection;
-
- /**
- * The key name
- */
- String name;
-
- /**
- * The value
- */
- String value;
-
- /**
- * The text content after entry
- */
- String suffix;
-
- Entry forValue(final String newValue) {
- final Entry e = new Entry();
- e.prefix = prefix;
- e.section = section;
- e.subsection = subsection;
- e.name = name;
- e.value = newValue;
- e.suffix = suffix;
- return e;
- }
-
- boolean match(final String aSection, final String aSubsection,
- final String aKey) {
- return eqIgnoreCase(section, aSection)
- && eqSameCase(subsection, aSubsection)
- && eqIgnoreCase(name, aKey);
- }
-
- boolean match(final String aSection, final String aSubsection) {
- return eqIgnoreCase(section, aSection)
- && eqSameCase(subsection, aSubsection);
- }
-
- private static boolean eqIgnoreCase(final String a, final String b) {
- if (a == null && b == null)
- return true;
- if (a == null || b == null)
- return false;
- return StringUtils.equalsIgnoreCase(a, b);
- }
-
- private static boolean eqSameCase(final String a, final String b) {
- if (a == null && b == null)
- return true;
- if (a == null || b == null)
- return false;
- return a.equals(b);
- }
- }
-
- private static class StringReader {
- private final char[] buf;
-
- private int pos;
-
- StringReader(final String in) {
- buf = in.toCharArray();
- }
-
- int read() {
- try {
- return buf[pos++];
- } catch (ArrayIndexOutOfBoundsException e) {
- pos = buf.length;
- return -1;
- }
- }
-
- void reset() {
- pos--;
- }
- }
- }
|