org.onosproject.cli

Class AbstractShellCommand

java.lang.Object

org.apache.karaf.shell.console.AbstractAction

org.apache.karaf.shell.console.OsgiCommandSupport

org.onosproject.cli.AbstractShellCommand

All Implemented Interfaces:

org.apache.felix.gogo.commands.Action, org.apache.karaf.shell.console.BundleContextAware

Direct Known Subclasses:

AddFlowsCommand, AddressBindingsListCommand, ApplicationIdListCommand, BalanceMastersCommand, ConnectivityIntentCommand, DeviceRemoveCommand, DeviceRoleCommand, DevicesListCommand, FlowsListCommand, GetStatistics, HostRemoveCommand, HostsListCommand, IntentPushTestCommand, IntentRemoveCommand, IntentsListCommand, LeaderCommand, LinksListCommand, MastersListCommand, MetricsListCommand, NodeAddCommand, NodeRemoveCommand, NodesListCommand, RandomIntentCommand, ResourceAllocationsCommand, ResourceAvailableCommand, RolesCommand, SummaryCommand, TabletAddCommand, TabletLeaderCommand, TabletMemberCommand, TabletRemoveCommand, TopologyCommand

public abstract class AbstractShellCommand
extends org.apache.karaf.shell.console.OsgiCommandSupport

Base abstraction of Karaf shell commands.

Field Summary

Fields inherited from class org.apache.karaf.shell.console.OsgiCommandSupport

bundleContext, usedReferences

Fields inherited from class org.apache.karaf.shell.console.AbstractAction

log, session

Constructor Summary

Constructors

Constructor and Description
AbstractShellCommand()

Method Summary

Modifier and Type	Method and Description
static String	annotations(org.onosproject.net.Annotations annotations) Produces a string image of the specified key/value annotations.
static com.fasterxml.jackson.databind.node.ObjectNode	annotations(com.fasterxml.jackson.databind.ObjectMapper mapper, org.onosproject.net.Annotations annotations) Produces a JSON object from the specified key/value annotations.
protected org.onosproject.core.ApplicationId	appId() Returns application ID for the CLI.
protected Object	doExecute()
void	error(String format, Object... args) Prints the arguments using the specified format to error stream.
protected abstract void	execute() Executes this command.
static <T> T	get(Class<T> serviceClass) Returns the reference to the implementation of the specified service.
protected boolean	outputJson() Indicates whether JSON format should be output.
void	print(String format, Object... args) Prints the arguments using the specified format.

Methods inherited from class org.apache.karaf.shell.console.OsgiCommandSupport

execute, getAllServices, getBundleContext, getService, getService, getService, setBundleContext, ungetServices

Methods inherited from class org.apache.karaf.shell.console.AbstractAction

checkInterrupted

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractShellCommand

public AbstractShellCommand()

Method Detail

get

public static <T> T get(Class<T> serviceClass)

Returns the reference to the implementation of the specified service.

Type Parameters:

T - type of service

Parameters:

serviceClass - service class

Returns:

service implementation

Throws:

org.onlab.osgi.ServiceNotFoundException - if service is unavailable

appId

protected org.onosproject.core.ApplicationId appId()

Returns application ID for the CLI.

Returns:

command-line application identifier

print

public void print(String format,
                  Object... args)

Prints the arguments using the specified format.

Parameters:

format - format string; see String.format(java.lang.String, java.lang.Object...)

args - arguments

error

public void error(String format,
                  Object... args)

Prints the arguments using the specified format to error stream.

Parameters:

format - format string; see String.format(java.lang.String, java.lang.Object...)

args - arguments

annotations

public static String annotations(org.onosproject.net.Annotations annotations)

Produces a string image of the specified key/value annotations.

Parameters:

annotations - key/value annotations

Returns:

string image with ", k1=v1, k2=v2, ..." pairs

annotations

public static com.fasterxml.jackson.databind.node.ObjectNode annotations(com.fasterxml.jackson.databind.ObjectMapper mapper,
                                                                         org.onosproject.net.Annotations annotations)

Produces a JSON object from the specified key/value annotations.

Parameters:

mapper - ObjectMapper to use while converting to JSON

annotations - key/value annotations

Returns:

JSON object

execute

protected abstract void execute()

Executes this command.

outputJson

protected boolean outputJson()

Indicates whether JSON format should be output.

Returns:

true if JSON is requested

doExecute

protected Object doExecute()
                    throws Exception

Specified by:

doExecute in class org.apache.karaf.shell.console.AbstractAction

Throws:

Exception