log4j优化文件 logging-log4j2-log4j-2.15.0-rc1.tar

/* * 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.logging.log4j.core.tools.picocli; import java.io.File; import java.io.PrintStream; import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; import java.lang.reflect.Array; import java.lang.reflect.Constructor; import java.lang.reflect.Field; import java.lang.reflect.ParameterizedType; import java.lang.reflect.Type; import java.lang.reflect.WildcardType; import java.math.BigDecimal; import java.math.BigInteger; import java.net.InetAddress; import java.net.MalformedURLException; import java.net.URI; import java.net.URISyntaxException; import java.net.URL; import java.nio.charset.Charset; import java.nio.file.Path; import java.nio.file.Paths; import java.sql.Time; import java.text.BreakIterator; import java.text.ParseException; import java.text.SimpleDateFormat; import java.util.ArrayList; import java.util.Arrays; import java.util.Collection; import java.util.Collections; import java.util.Comparator; import java.util.Date; import java.util.HashMap; import java.util.HashSet; import java.util.LinkedHashMap; import java.util.LinkedHashSet; import java.util.LinkedList; import java.util.List; import java.util.Map; import java.util.Queue; import java.util.Set; import java.util.SortedSet; import java.util.Stack; import java.util.TreeSet; import java.util.UUID; import java.util.concurrent.Callable; import java.util.regex.Pattern; import org.apache.logging.log4j.core.tools.picocli.CommandLine.Help.Ansi.IStyle; import org.apache.logging.log4j.core.tools.picocli.CommandLine.Help.Ansi.Style; import org.apache.logging.log4j.core.tools.picocli.CommandLine.Help.Ansi.Text; import static java.util.Locale.ENGLISH; import static org.apache.logging.log4j.core.tools.picocli.CommandLine.Help.Column.Overflow.SPAN; import static org.apache.logging.log4j.core.tools.picocli.CommandLine.Help.Column.Overflow.TRUNCATE; import static org.apache.logging.log4j.core.tools.picocli.CommandLine.Help.Column.Overflow.WRAP; /** * <p> * CommandLine interpreter that uses reflection to initialize an annotated domain object with values obtained from the * command line arguments. * </p><h2>Example</h2> * <pre>import static picocli.CommandLine.*; * * &#064;Command(header = "Encrypt FILE(s), or standard input, to standard output or to the output file.", * version = "v1.2.3") * public class Encrypt { * * &#064;Parameters(type = File.class, description = "Any number of input files") * private List&lt;File&gt; files = new ArrayList&lt;File&gt;(); * * &#064;Option(names = { "-o", "--out" }, description = "Output file (default: print to console)") * private File outputFile; * * &#064;Option(names = { "-v", "--verbose"}, description = "Verbosely list files processed") * private boolean verbose; * * &#064;Option(names = { "-h", "--help", "-?", "-help"}, usageHelp = true, description = "Display this help and exit") * private boolean help; * * &#064;Option(names = { "-V", "--version"}, versionHelp = true, description = "Display version info and exit") * private boolean versionHelp; * } * </pre> * <p> * Use {@code CommandLine} to initialize a domain object as follows: * </p><pre> * public static void main(String... args) { * Encrypt encrypt = new Encrypt(); * try { * List&lt;CommandLine&gt; parsedCommands = new CommandLine(encrypt).parse(args); * if (!CommandLine.printHelpIfRequested(parsedCommands, System.err, Help.Ansi.AUTO)) { * runProgram(encrypt); * } * } catch (ParameterException ex) { // command line arguments could not be parsed * System.err.println(ex.getMessage()); * ex.getCommandLine().usage(System.err); * } * } * </pre><p> * Invoke the above program with some command line arguments. The below are all equivalent: * </p> * <pre> * --verbose --out=outfile in1 in2 * --verbose --out outfile in1 in2 * -v --out=outfile in1 in2 * -v -o outfile in1 in2 * -v -o=outfile in1 in2 * -vo outfile in1 in2 * -vo=outfile in1 in2 * -v -ooutfile in1 in2 * -vooutfile in1 in2 * </pre> */ public class CommandLine { /** This is picocli version {@value}. */ public static final String VERSION = "2.0.3"; private final Tracer tracer = new Tracer(); private final Interpreter interpreter; private String commandName = Help.DEFAULT_COMMAND_NAME; private boolean overwrittenOptionsAllowed = false; private boolean unmatchedArgumentsAllowed = false; private final List<String> unmatchedArguments = new ArrayList<>(); private CommandLine parent; private boolean usageHelpRequested; private boolean versionHelpRequested; private final List<String> versionLines = new ArrayList<>(); /** * Constructs a new {@code CommandLine} interpreter with the specified annotated object. * When the {@link #parse(String...)} method is called, fields of the specified object that are annotated * with {@code @Option} or {@code @Parameters} will be initialized based on command line arguments. * @param command the object to initialize from the command line arguments * @throws InitializationException if the specified command object does not have a {@link Command}, {@link Option} or {@link Parameters} annotation */ public CommandLine(final Object command) { interpreter = new Interpreter(command); } /** Registers a subcommand with the specified name. For example: * <pre> * CommandLine commandLine = new CommandLine(new Git()) * .addSubcommand("status", new GitStatus()) * .addSubcommand("commit", new GitCommit(); * .addSubcommand("add", new GitAdd()) * .addSubcommand("branch", new GitBranch()) * .addSubcommand("checkout", new GitCheckout()) * //... * ; * </pre> * * <p>The specified object can be an annotated object or a * {@code CommandLine} instance with its own nested subcommands. For example:</p> * <pre> * CommandLine commandLine = new CommandLine(new MainCommand()) * .addSubcommand("cmd1", new ChildCommand1()) // subcommand * .addSubcommand("cmd2", new ChildCommand2()) * .addSubcommand("cmd3", new CommandLine(new ChildCommand3()) // subcommand with nested sub-subcommands * .addSubcommand("cmd3sub1", new GrandChild3Command1()) * .addSubcommand("cmd3sub2", new GrandChild3Command2()) * .addSubcommand("cmd3sub3", new CommandLine(new GrandChild3Command3()) // deeper nesting * .addSubcommand("cmd3sub3sub1", new GreatGrandChild3Command3_1()) * .addSubcommand("cmd3sub3sub2", new GreatGrandChild3Command3_2()) * ) * ); * </pre> * <p>The default type converters are available on all subcommands and nested sub-subcommands, but custom type * converters are registered only with the subc