org.eclipse.jgit.pgm
Class CommandCatalog

java.lang.Object
  extended by org.eclipse.jgit.pgm.CommandCatalog

public class CommandCatalog
extends java.lang.Object

List of all commands known by jgit's command line tools.

Commands are implementations of TextBuiltin, with an optional Command class annotation to insert additional documentation or override the default command name (which is guessed from the class name).

Commands may be registered by adding them to a services file in the same JAR (or classes directory) as the command implementation. The service file name is META-INF/services/org.eclipse.jgit.pgm.TextBuiltin and it contains one concrete implementation class name per line.

Command registration is identical to Java 6's services, however the catalog uses a lightweight wrapper to delay creating a command instance as much as possible. This avoids initializing the AWT or SWT GUI toolkits even if the command's constructor might require them.


Method Summary
static CommandRef[] all()
           
static CommandRef[] common()
           
static CommandRef get(java.lang.String name)
          Locate a single command by its user friendly name.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

get

public static CommandRef get(java.lang.String name)
Locate a single command by its user friendly name.

Parameters:
name - name of the command. Typically in dash-lower-case-form, which was derived from the DashLowerCaseForm class name.
Returns:
the command instance; null if no command exists by that name.

all

public static CommandRef[] all()
Returns:
all known commands, sorted by command name.

common

public static CommandRef[] common()
Returns:
all common commands, sorted by command name.


Copyright © 2011. All Rights Reserved.