12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424 |
- /*
- * 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.AbstractSet;
- import java.util.ArrayList;
- import java.util.Collections;
- import java.util.Iterator;
- import java.util.LinkedHashMap;
- import java.util.LinkedHashSet;
- import java.util.List;
- import java.util.Map;
- import java.util.Set;
- import java.util.concurrent.atomic.AtomicReference;
-
- 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.internal.JGitText;
- 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<ConfigSnapshot> 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<ConfigSnapshot>(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 ConfigSnapshot 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 ConfigLine 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 ConfigSnapshot getState() {
- ConfigSnapshot cur, upd;
- do {
- cur = state.get();
- final ConfigSnapshot base = getBaseState();
- if (cur.baseState == base)
- return cur;
- upd = new ConfigSnapshot(cur.entryList, base);
- } while (!state.compareAndSet(cur, upd));
- return upd;
- }
-
- private ConfigSnapshot 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) {
- ConfigSnapshot src, res;
- do {
- src = state.get();
- res = unsetSection(src, section, subsection);
- } while (!state.compareAndSet(src, res));
- }
-
- private ConfigSnapshot unsetSection(final ConfigSnapshot srcState,
- final String section,
- final String subsection) {
- final int max = srcState.entryList.size();
- final ArrayList<ConfigLine> r = new ArrayList<ConfigLine>(max);
-
- boolean lastWasMatch = false;
- for (ConfigLine 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) {
- ConfigSnapshot src, res;
- do {
- src = state.get();
- res = replaceStringList(src, section, subsection, name, values);
- } while (!state.compareAndSet(src, res));
- if (notifyUponTransientChanges())
- fireConfigChangedEvent();
- }
-
- private ConfigSnapshot replaceStringList(final ConfigSnapshot srcState,
- final String section, final String subsection, final String name,
- final List<String> values) {
- final List<ConfigLine> 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 ConfigLine 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 ConfigLine 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 ConfigLine e = new ConfigLine();
- e.section = section;
- e.subsection = subsection;
- entries.add(e);
- insertPosition = entries.size();
- }
- while (valueIndex < values.size()) {
- final ConfigLine e = new ConfigLine();
- e.section = section;
- e.subsection = subsection;
- e.name = name;
- e.value = values.get(valueIndex++);
- entries.add(insertPosition++, e);
- }
- }
-
- return newState(entries);
- }
-
- private static List<ConfigLine> copy(final ConfigSnapshot 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<ConfigLine> r = new ArrayList<ConfigLine>(max);
- r.addAll(src.entryList);
- return r;
- }
-
- private static int findSectionEnd(final List<ConfigLine> entries,
- final String section, final String subsection) {
- for (int i = 0; i < entries.size(); i++) {
- ConfigLine 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 ConfigLine 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<ConfigLine> newEntries = new ArrayList<ConfigLine>();
- final StringReader in = new StringReader(text);
- ConfigLine last = null;
- ConfigLine e = new ConfigLine();
- 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 ConfigLine();
-
- } 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 ConfigSnapshot newState() {
- return new ConfigSnapshot(Collections.<ConfigLine> emptyList(),
- getBaseState());
- }
-
- private ConfigSnapshot newState(final List<ConfigLine> entries) {
- return new ConfigSnapshot(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 LinkedHashSet<String>();
- while (cfg != null) {
- for (final ConfigLine 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 Map<String, String> m = new LinkedHashMap<String, String>();
- while (cfg != null) {
- for (final ConfigLine e : cfg.state.get().entryList) {
- if (e.name == null)
- continue;
- if (!StringUtils.equalsIgnoreCase(section, e.section))
- continue;
- if ((subsection == null && e.subsection == null)
- || (subsection != null && subsection
- .equals(e.subsection))) {
- String lc = StringUtils.toLowerCase(e.name);
- if (!m.containsKey(lc))
- m.put(lc, e.name);
- }
- }
- cfg = cfg.baseConfig;
- }
- return new CaseFoldingSet(m);
- }
- }
-
- private static class SectionNames implements SectionParser<Set<String>> {
- public Set<String> parse(Config cfg) {
- final Map<String, String> m = new LinkedHashMap<String, String>();
- while (cfg != null) {
- for (final ConfigLine e : cfg.state.get().entryList) {
- if (e.section != null) {
- String lc = StringUtils.toLowerCase(e.section);
- if (!m.containsKey(lc))
- m.put(lc, e.section);
- }
- }
- cfg = cfg.baseConfig;
- }
- return new CaseFoldingSet(m);
- }
- }
-
- private static class CaseFoldingSet extends AbstractSet<String> {
- private final Map<String, String> names;
-
- CaseFoldingSet(Map<String, String> names) {
- this.names = Collections.unmodifiableMap(names);
- }
-
- @Override
- public boolean contains(Object needle) {
- if (!(needle instanceof String))
- return false;
-
- String n = (String) needle;
- return names.containsKey(n)
- || names.containsKey(StringUtils.toLowerCase(n));
- }
-
- @Override
- public Iterator<String> iterator() {
- return names.values().iterator();
- }
-
- @Override
- public int size() {
- return names.size();
- }
- }
-
- 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--;
- }
- }
- }
|