diff options
Diffstat (limited to 'sca-java-2.x/tags/2.0-Beta2-RC1/modules/shell/src/main/java/org/apache/tuscany/sca/shell/Shell.java')
| -rw-r--r-- | sca-java-2.x/tags/2.0-Beta2-RC1/modules/shell/src/main/java/org/apache/tuscany/sca/shell/Shell.java | 968 |
1 files changed, 0 insertions, 968 deletions
diff --git a/sca-java-2.x/tags/2.0-Beta2-RC1/modules/shell/src/main/java/org/apache/tuscany/sca/shell/Shell.java b/sca-java-2.x/tags/2.0-Beta2-RC1/modules/shell/src/main/java/org/apache/tuscany/sca/shell/Shell.java deleted file mode 100644 index 8353c9eb84..0000000000 --- a/sca-java-2.x/tags/2.0-Beta2-RC1/modules/shell/src/main/java/org/apache/tuscany/sca/shell/Shell.java +++ /dev/null @@ -1,968 +0,0 @@ -/*
- * 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.tuscany.sca.shell;
-
-import static java.lang.System.in;
-import static java.lang.System.out;
-
-import java.io.BufferedReader;
-import java.io.File;
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.InputStreamReader;
-import java.lang.reflect.InvocationTargetException;
-import java.lang.reflect.Method;
-import java.net.URL;
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-import java.util.concurrent.Callable;
-
-import org.apache.tuscany.sca.Node;
-import org.apache.tuscany.sca.TuscanyRuntime;
-import org.apache.tuscany.sca.assembly.Binding;
-import org.apache.tuscany.sca.assembly.Composite;
-import org.apache.tuscany.sca.assembly.Endpoint;
-import org.apache.tuscany.sca.assembly.SCABinding;
-import org.apache.tuscany.sca.common.java.io.IOHelper;
-import org.apache.tuscany.sca.contribution.Artifact;
-import org.apache.tuscany.sca.contribution.Contribution;
-import org.apache.tuscany.sca.contribution.processor.ContributionReadException;
-import org.apache.tuscany.sca.impl.NodeImpl;
-import org.apache.tuscany.sca.monitor.ValidationException;
-import org.apache.tuscany.sca.runtime.ActivationException;
-import org.apache.tuscany.sca.runtime.EndpointRegistry;
-import org.apache.tuscany.sca.runtime.Version;
-import org.apache.tuscany.sca.shell.jline.JLine;
-import org.oasisopen.sca.NoSuchServiceException;
-
-/**
- * A little SCA command shell.
- */
-public class Shell {
-
- private boolean useJline;
- final List<String> history = new ArrayList<String>();
- private TuscanyRuntime runtime;
- private String currentDomain = "";
- private Map<String, Node> standaloneNodes = new HashMap<String, Node>();
- private Map<String, Node> nodes = new HashMap<String, Node>();
-
- public static final String[] COMMANDS = new String[] {"bye", "domain", "domains", "help", "install", "installed", "invoke",
- "load", "remove", "run", "save", "services", "start", "started", "stop"};
-
- public static void main(final String[] args) throws Exception {
- boolean useJline = true;
- String domainURI = "default";
-
- String contribution = null;
- for (String s : args) {
- if ("-nojline".equals(s)) {
- useJline = false;
- } else {
- if (s.startsWith("uri:") || s.startsWith("properties:")) {
- domainURI = s;
- } else {
- contribution = s;
- }
- }
- }
- Shell shell = new Shell(domainURI, useJline);
- if (contribution != null) {
- shell.install(Arrays.asList(new String[]{"install", contribution, "-start"}));
- }
- shell.run(contribution==null);
- }
-
- public Shell(String domainURI, boolean useJLine) {
- this.runtime = TuscanyRuntime.newInstance();
- this.useJline = useJLine;
- if (domainURI != null) {
- domain(domainURI);
- }
- }
-
- boolean domain(final String domainURI) {
- if (domainURI.length() < 1) {
- currentDomain = "";
- } else {
- for (Node node : nodes.values()) {
- if (domainURI.equals(node.getDomainName())) {
- currentDomain = node.getDomainName();
- return true;
- }
- }
- Node node = runtime.createNode(domainURI);
- currentDomain = node.getDomainName();
- nodes.put(currentDomain, node);
- }
- return true;
- }
-
- boolean domains() {
- for (Node node : nodes.values()) {
- System.out.println(node.getDomainName());
- }
- return true;
- }
-
- boolean install(final List<String> toks) throws ContributionReadException, ActivationException, ValidationException {
- if (getNode() == null) {
- out.println("not in domain, use domain command first");
- return true;
- }
- boolean startDeployables = toks.contains("-start");
- String metaDataURL = null;
- if (toks.contains("-metadata")) {
- metaDataURL = toks.get(toks.indexOf("-metadata") + 1);
- }
- List<String> duris = null;
- if (toks.contains("-duris")) {
- duris = Arrays.asList(toks.get(toks.indexOf("-duris") + 1).split(","));
- }
-
- String first = null;
- String second = null;
- for (int i = 1; i < toks.size(); i++) {
- if (toks.get(i).startsWith("-")) {
- if (!toks.get(i).equals("-start")) {
- i++;
- }
- } else {
- if (first == null) {
- first = toks.get(i);
- } else {
- second = toks.get(i);
- break;
- }
- }
- }
-
- String curi = null;
- String curl = null;
- if (second != null) {
- curi = first;
- curl = second;
- } else {
- curl = first;
- }
-
- curl = mavenProject(curl);
-
- String uri = getNode().installContribution(curi, curl, metaDataURL, duris, startDeployables);
- out.println("installed at: " + uri);
- return true;
- }
-
- /**
- * Try to simplify pointing at a Maven project contribution without needing target/classes suffix
- */
- private String mavenProject(String curl) {
- File f = new File(curl);
- if (!f.exists()) {
- return curl;
- }
- f = new File(f, "target");
- if (!f.exists()) {
- return curl;
- }
- f = new File(f, "classes");
- if (f.exists()) {
- return f.toURI().toString();
- }
- // TODO: look for .zip or .jar in target?
- return curl;
- }
-
- boolean installed(final List<String> toks) {
- List<String> curis;
- if (toks.size() > 1) {
- curis = Arrays.asList(new String[] {toks.get(1)});
- } else {
- if (getNode() == null) {
- return true;
- }
- curis = getNode().getInstalledContributionURIs();
- }
- for (String curi : curis) {
- out.println(curi + " " + getNode().getInstalledContribution(curi).getLocation());
- Contribution c = getNode().getInstalledContribution(curi);
- List<String> deployeds = getNode().getStartedCompositeURIs(curi);
- for (Artifact a : c.getArtifacts()) {
- if (a.getModel() instanceof Composite) {
- Composite composite = (Composite)a.getModel();
- String running = deployeds.contains(composite.getURI()) ? "***running***" : "";
- out.println(" " + composite.getURI() + " " + composite.getName() + " " + running);
- }
- }
- }
- return true;
- }
-
- boolean invoke(final List<String> toks) throws SecurityException, NoSuchMethodException, IllegalArgumentException, IllegalAccessException, InvocationTargetException, NoSuchServiceException {
- String endpointName = toks.get(1);
- String operationName = toks.get(2);
- String params[] = new String[toks.size()- 3];
- System.arraycopy(toks.toArray(), 3, params, 0, params.length);
- Object proxy = getNode().getService(null, endpointName);
- Object result = invoke(proxy, operationName, params);
- if (result != null && result.getClass().isArray()) {
- out.println(Arrays.toString((Object[])result));
- } else {
- out.println(result);
- }
- return true;
- }
-
- static Object invoke(Object proxy, String operationName, String... params) throws IllegalAccessException, InvocationTargetException {
- for (Method m : proxy.getClass().getMethods()) {
- if (m.getName().equals(operationName) && m.getParameterTypes().length == params.length) {
- Object parameters[] = new Object[params.length];
- int i = 0;
- for (Class<?> type : m.getParameterTypes()) {
- if (type == byte.class || type == Byte.class) {
- parameters[i] = Byte.valueOf(params[i]);
- } else if (type == char.class || type == Character.class) {
- parameters[i] = params[i].charAt(0);
- } else if (type == boolean.class || type == Boolean.class) {
- parameters[i] = Boolean.valueOf(params[i]);
- } else if (type == short.class || type == Short.class) {
- parameters[i] = Short.valueOf(params[i]);
- } else if (type == int.class || type == Integer.class) {
- parameters[i] = Integer.valueOf(params[i]);
- } else if (type == long.class || type == Long.class) {
- parameters[i] = Long.valueOf(params[i]);
- } else if (type == float.class || type == Float.class) {
- parameters[i] = Float.valueOf(params[i]);
- } else if (type == double.class || type == Double.class) {
- parameters[i] = Double.valueOf(params[i]);
- } else if (type == String.class) {
- parameters[i] = params[i];
- } else {
- throw new IllegalArgumentException("Parameter type is not supported: " + type);
- }
- i++;
- }
- Object result = m.invoke(proxy, parameters);
- return result;
- }
- }
- throw new IllegalArgumentException("Invalid service operation: " + operationName);
- }
-
- boolean listComposites(final String curi) {
- if (getNode() == null) {
- return true;
- }
- Contribution c = getNode().getInstalledContribution(curi);
- for (Artifact a : c.getArtifacts()) {
- if (a.getModel() instanceof Composite) {
- out.println(((Composite)a.getModel()).getName());
- }
- }
- return true;
- }
-
- boolean load(final String configXmlUrl) throws ContributionReadException, ActivationException, ValidationException {
- Node node = runtime.createNodeFromXML(configXmlUrl);
- currentDomain = node.getDomainName();
- nodes.put(currentDomain, node);
- return true;
- }
-
- boolean remove(final String curi) throws ContributionReadException, ActivationException, ValidationException {
- if (getNode() == null) {
- out.println("not in domain, use domain command first");
- return true;
- }
- getNode().removeContribution(curi);
- return true;
- }
-
- boolean run(final String commandsFileURL) throws IOException {
- BufferedReader r = new BufferedReader(new InputStreamReader(IOHelper.getLocationAsURL(commandsFileURL).openStream()));
- String l;
- try {
- while ((l = r.readLine()) != null) {
- out.println(l);
- String[] toks = l != null ? l.trim().split(" ") : "".split(" ");
- List<String> toksList = getTokens(toks);
- apply(eval(toksList));
- }
- } finally {
- r.close();
- }
- return true;
- }
-
- boolean save(final String directory) throws IOException {
- out.println("TODO: not yet implemented");
- return true;
- }
-
- boolean services() throws IOException {
- if (getNode() == null) {
- return true;
- }
- EndpointRegistry reg = ((NodeImpl)getNode()).getEndpointRegistry();
- for (Endpoint endpoint : reg.getEndpoints()) {
- out.println(endpoint.getComponent().getURI() + "/" + endpoint.getService().getName());
- for (Binding b : endpoint.getService().getBindings()) {
- if (!SCABinding.TYPE.equals(b.getType())) {
- out.println(" " + b.getType().getLocalPart() + " " + b.getURI());
- }
- }
- }
- return true;
- }
-
- public boolean stop(List<String> toks) throws ActivationException {
- String curi = toks.get(1);
- if (toks.size() > 2) {
- getNode().stop(curi, toks.get(2));
- } else {
- if (standaloneNodes.containsKey(curi)) {
- standaloneNodes.remove(curi).stop();
- } else if (nodes.containsKey(curi)) {
- Node n = nodes.remove(curi);
- n.stop();
- if (n.getDomainName().equals(currentDomain)) {
- currentDomain = "";
- }
- } else {
- for (String compositeURI : getNode().getStartedCompositeURIs(curi)) {
- getNode().stop(curi, compositeURI);
- }
- }
- }
- return true;
- }
-
- public boolean bye() {
- for (Node node : nodes.values()) {
- node.stop();
- }
- runtime.stop();
- for (Node node : standaloneNodes.values()) {
- node.stop();
- }
- return false;
- }
-
- boolean start(String curi, String compositeURI) throws ActivationException, ValidationException {
- Contribution c = getNode().getInstalledContribution(curi);
- for (Artifact a : c.getArtifacts()) {
- if (compositeURI.equals(a.getURI())) {
- getNode().start(curi, compositeURI);
- return true;
- }
- }
- // external composite file ('composite by value')
- try {
- URL url = IOHelper.getLocationAsURL(compositeURI);
- InputStream is = IOHelper.openStream(url);
- BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8"));
- getNode().start(curi, br);
- } catch (Exception e) {
- System.out.println(e);
- }
-
- return true;
- }
-
- boolean start(String nodeName, String compositeURI, String contributionURL, String... dependentContributionURLs)
- throws ActivationException, ValidationException {
- Node node = TuscanyRuntime.runComposite(compositeURI, contributionURL, dependentContributionURLs);
- standaloneNodes.put(nodeName, node);
- return true;
- }
-
- boolean started(final List<String> toks) {
- if (standaloneNodes.size() > 0) {
- out.println("Standalone Nodes:");
- for (String nodeName : standaloneNodes.keySet()) {
- Node node = standaloneNodes.get(nodeName);
- for (String curi : node.getInstalledContributionURIs()) {
- for (String dc : node.getStartedCompositeURIs(curi)) {
- out.println(" " + nodeName + " " + dc);
- }
- }
- }
- out.println();
- }
- if (nodes.size() > 0) {
- for (Node node : nodes.values()) {
- out.println("Domain: " + node.getDomainName());
- List<String> ics;
- if (toks.size() > 1) {
- ics = new ArrayList<String>();
- ics.add(toks.get(1));
- } else {
- ics = node.getInstalledContributionURIs();
- }
-
- for (String curi : ics) {
- Contribution c = node.getInstalledContribution(curi);
- List<String> dcs = node.getStartedCompositeURIs(curi);
- if (toks.size() > 2) {
- dcs = new ArrayList<String>();
- dcs.add(toks.get(2));
- } else {
- dcs = node.getStartedCompositeURIs(curi);
- }
- for (String compositeUri : dcs) {
- for (Artifact a : c.getArtifacts()) {
- if (compositeUri.equals(a.getURI())) {
- out.println(" " + curi
- + " "
- + compositeUri
- + " "
- + ((Composite)a.getModel()).getName());
- }
- }
- }
- }
- }
- }
- return true;
- }
-
- boolean status() {
- return true;
- }
-
- boolean history() {
- for (String l : history)
- out.println(l);
- return true;
- }
-
- public Node getNode() {
- return nodes.get(currentDomain);
- }
-
- List<String> read(Object r) throws IOException {
- out.println();
- out.print(currentDomain + "> ");
- final String l;
- if (useJline) {
- l = JLine.readLine(r);
- } else {
- l = ((BufferedReader)r).readLine();
- history.add(l);
- }
-
- String[] toks = l != null ? l.trim().split(" ") : "bye".split(" ");
- return getTokens(toks);
- }
-
- /**
- * Parse the string into tokens, which may include quoted strings
- */
- List<String> getTokens(String[] toks) {
- List<String> toksList = new ArrayList<String>();
- for (int i=0; i<toks.length; i++) {
- if (toks[i] != null && toks[i].trim().length() > 0) {
- int j = quotedString(toks, i);
- if (j > -1) {
- StringBuilder sb = new StringBuilder();
- sb.append(toks[i]);
- for (int k=i+1; k<=j; k++) {
- sb.append(" ");
- sb.append(toks[k]);
- }
- i = j;
- String s = sb.toString();
- toksList.add(s.substring(1, s.length()-1));
- } else {
- toksList.add(toks[i]);
- }
- }
- }
- return toksList;
- }
-
- int quotedString(String[] toks, int i) {
- if (toks[i].startsWith("\"") || toks[i].startsWith("'")) {
- for (int j=i+1; j<toks.length; j++) {
- if (toks[j].endsWith(toks[i].substring(0,1))) {
- return j;
- }
- }
- }
- return -1;
- }
-
- Callable<Boolean> eval(final List<String> toks) {
- final String op = toks.size() > 0 ? toks.get(0) : "";
-
- if (op.equalsIgnoreCase("domain"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- return domain(toks.size() > 1 ? toks.get(1) : "");
- }
- };
- if (op.equalsIgnoreCase("domains"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- return domains();
- }
- };
- if (op.equalsIgnoreCase("install"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- return install(toks);
- }
- };
- if (op.equalsIgnoreCase("installed"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- return installed(toks);
- }
- };
- if (op.equalsIgnoreCase("invoke"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- return invoke(toks);
- }
- };
- if (op.equalsIgnoreCase("load"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- return load(toks.get(1));
- }
- };
- if (op.equalsIgnoreCase("remove"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- return remove(toks.get(1));
- }
- };
- if (op.equalsIgnoreCase("run"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- return run(toks.get(1));
- }
- };
- if (op.equalsIgnoreCase("help"))
- return new Callable<Boolean>() {
- public Boolean call() {
- return help(toks);
- }
- };
- if (op.equalsIgnoreCase("save"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- return save(toks.get(1));
- }
- };
- if (op.equalsIgnoreCase("stop"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- return stop(toks);
- }
- };
- if (op.equalsIgnoreCase("services"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- return services();
- }
- };
- if (op.equalsIgnoreCase("bye"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- return bye();
- }
- };
- if (op.equalsIgnoreCase("start"))
- return new Callable<Boolean>() {
- public Boolean call() throws Exception {
- if (currentDomain.length() > 0) {
- return start(toks.get(1), toks.get(2));
- } else {
- String[] duris = null;
- if (toks.contains("-duris")) {
- int i = toks.indexOf("-duris");
- duris = toks.get(i + 1).split(",");
- toks.remove(i); toks.remove(i+1);
- }
- String name = toks.get(1);
- String contributionURL;
- String compositeURI;
- if (toks.size() > 3) {
- compositeURI = toks.get(2);
- contributionURL = toks.get(3);
- } else {
- compositeURI = null;
- contributionURL = toks.get(2);
- }
- return start(name, compositeURI, contributionURL, duris);
- }
- }
- };
- if (op.equalsIgnoreCase("started"))
- return new Callable<Boolean>() {
- public Boolean call() {
- return started(toks);
- }
- };
- if (op.equalsIgnoreCase("status"))
- return new Callable<Boolean>() {
- public Boolean call() {
- return status();
- }
- };
- if (op.equalsIgnoreCase("history"))
- return new Callable<Boolean>() {
- public Boolean call() {
- return history();
- }
- };
- if (op.equalsIgnoreCase("") || op.startsWith("#"))
- return new Callable<Boolean>() {
- public Boolean call() {
- return true;
- }
- };
- return new Callable<Boolean>() {
- public Boolean call() {
- out.println("unknown command");
- return true;
- }
- };
- }
-
- boolean apply(final Callable<Boolean> func) {
- try {
- return func.call();
- } catch (Exception e) {
- e.printStackTrace();
- return true;
- }
- }
-
- public void run(boolean initialHelp) throws IOException {
- if (initialHelp) {
- help(null);
- }
- Object reader;
- if (useJline) {
- reader = JLine.createJLineReader(this);
- } else {
- reader = new BufferedReader(new InputStreamReader(in));
- }
- while (apply(eval(read(reader))))
- ;
- }
-
- boolean help(List<String> toks) {
- String command = (toks == null || toks.size() < 2) ? null : toks.get(1);
- if (command == null) {
- helpOverview();
- } else if ("help".equalsIgnoreCase(command)) {
- helpHelp();
- } else if ("install".equalsIgnoreCase(command)) {
- helpInstall();
- } else if ("installed".equalsIgnoreCase(command)) {
- helpInstalled();
- } else if ("invoke".equalsIgnoreCase(command)) {
- helpInvoke();
- } else if ("load".equalsIgnoreCase(command)) {
- helpLoad();
- } else if ("remove".equalsIgnoreCase(command)) {
- helpRemove();
- } else if ("run".equalsIgnoreCase(command)) {
- helpRun();
- } else if ("save".equalsIgnoreCase(command)) {
- helpSave();
- } else if ("start".equalsIgnoreCase(command)) {
- helpStart();
- } else if ("started".equalsIgnoreCase(command)) {
- helpStarted();
- } else if ("stop".equalsIgnoreCase(command)) {
- helpStop();
- } else if ("startup".equalsIgnoreCase(command)) {
- helpStartUp();
- } else if ("status".equalsIgnoreCase(command)) {
- helpStatus();
- } else if ("services".equalsIgnoreCase(command)) {
- helpServices();
- } else if ("bye".equalsIgnoreCase(command)) {
- helpBye();
- }
- return true;
- }
-
- boolean helpOverview() {
- out.println("Apache Tuscany Shell (" + Version.getVersion()
- + " "
- + Version.getRevsion()
- + " "
- + Version.getBuildTime()
- + ")");
- out.println("Commands:");
- out.println();
- out.println(" help");
- out.println(" domain <domainURI>");
- out.println(" domains");
- out.println(" install [<uri>] <contributionURL> [-start] [-metadata <url>] [-duris <uri,uri,...>]");
- out.println(" installed [<contributionURI>]");
- out.println(" invoke <component>[/<service>] <operation> [<arg0> <arg1> ...]");
- out.println(" load <configXmlURL>");
- out.println(" remove <contributionURI>");
- out.println(" run <commandsFileURL>");
- out.println(" save <directoryPath>");
- out.println(" services");
- out.println(" start <curi> <compositeUri>|<contentURL>");
- out.println(" start <name> [<compositeUri>] <contributionURL> [-duris <uri,uri,...>]");
- out.println(" started [<curi> [<compositeUri>]]");
- out.println(" status");
- out.println(" stop [<curi> [<compositeUri>]]");
- out.println(" bye");
- out.println();
- if (useJline)
- out.println("Use Tab key for command and argument completion");
- out.println("For detailed help on each command do 'help <command>', for help of startup options do 'help startup'");
- return true;
- }
-
- void helpHelp() {
- out.println(" help [<command>]");
- out.println();
- out.println(" Outputs help on the Tuscany Shell");
- out.println(" If the command argument is used it provides detailed help on that command otherwise");
- out.println(" it provides an overview of available Shell commands");
- out.println();
- out.println(" To get help on starting the Tuscany Shell use 'help startup'");
- out.println();
- out.println(" Arguments:");
- out.println(" <command> - (optional) the command to get detailed help on");
- }
-
- void helpDomain() {
- out.println(" domain [<domainURI>]");
- out.println();
- out.println(" Starts or connects to a domain for the given domain URI.");
- out.println(" If no domain URI is specified switch to standalone mode.");
- out.println();
- out.println(" Arguments:");
- out.println(" <domainURI> - (optional) the domain URI of the domain");
- }
-
- void helpDomains() {
- out.println(" domains");
- out.println();
- out.println(" Shows the currently defined domain URIs");
- out.println();
- out.println(" Arguments:");
- out.println(" none");
- }
-
- void helpInstall() {
- out.println(" install [<uri>] <contributionURL> [-start] [-metadata <url>] [-duris <uri,uri,...>]");
- out.println();
- out.println(" Creates an installed contribution with a supplied root contribution, installed at abase URI.");
- out.println();
- out.println(" Arguments:");
- out.println(" uri - (optional) the URI (name) to use for the contribution. When no uri is specified");
- out.println(" a default URI is used derived from the contribution URL");
- out.println(" contributionURL - (required) the URL to the contribution to install");
- out.println(" -start - (optional) start any composites listed as deployable in the sca-contribution.xml file");
- out.println(" -metadata <url> - (optional) the URL to an external contribution meta data document that should be");
- out.println(" merged into any existing sca-contributions.xml file within the contribution.");
- out.println(" -duris <uri,uri,...> - (optional) specifies the URIs of contributions that are used to resolve the");
- out.println(" dependencies of the root contribution and other dependent contributions.");
- out.println(" When not specified all installed contributions are used to resolve dependencies.");
- }
-
- void helpInstalled() {
- out.println(" installed [<contributionURI>]");
- out.println();
- out.println(" Shows information about the contributions installed on this node,");
- out.println(" including the contribution URI and location along with the URI");
- out.println(" and QName of any composites within the contribution");
- out.println();
- out.println(" Arguments:");
- out.println(" contributionURI - (optional) the URI of an installed contribution");
- }
-
- void helpInvoke() {
- out.println(" invoke <component>[/<service>] <operation> [<arg0> <arg1> ...]");
- out.println();
- out.println(" Invokes an operation of a component service.");
- out.println(" (presently parameters and return values are limited to simple types)");
- out.println();
- out.println(" Arguments:");
- out.println(" component - (required) the name of the component");
- out.println(" service - (optional) the name of the component service, which may be omitted");
- out.println(" when the component has a single service.");
- out.println(" operation - (required) the name of the operation");
- out.println(" args - (optional) the operation arguments");
- }
-
- void helpLoad() {
- out.println(" load <configXmlUrl>");
- out.println();
- out.println(" Shows information about the contributions installed on this node,");
- out.println(" including the contribution URI and location along with the URI");
- out.println(" and QName of any composites within the contribution");
- out.println();
- out.println(" Arguments:");
- out.println(" configXmlUrl - (required) the URL of the config file to load");
- }
-
- void helpRemove() {
- out.println(" remove <contributionURI>");
- out.println();
- out.println(" Removes an installed contribution");
- out.println();
- out.println(" Arguments:");
- out.println(" contributionURI - (required) the URI of an installed contribution");
- }
-
- void helpRun() {
- out.println(" run <commandsFileURL>");
- out.println();
- out.println(" Runs shell commands stored in file.");
- out.println(" The file should be a text file with one shell command per line. Blank lines and ");
- out.println(" lines starting with # will be ignored.");
- out.println();
- out.println(" Arguments:");
- out.println(" commandsFileURL - (required) the URL of the commands file to run");
- }
-
- void helpSave() {
- out.println(" save <directoryPath>");
- out.println();
- out.println(" Saves the current Node state to directory.");
- out.println(" This will include a node-config.xml file and copies of all artifacts");
- out.println(" being used by the Node.");
- out.println();
- out.println(" Arguments:");
- out.println(" directoryPath - (required) the URL of a directory to be used to store the state.");
- }
-
- void helpServices() {
- out.println(" services");
- out.println();
- out.println(" Lists the components and services available in the Domain.");
- out.println();
- out.println(" Arguments:");
- out.println(" none");
- }
-
- void helpStart() {
- out.println(" start <curi> <compositeUri>|<contentURL>");
- out.println(" start <name> [<compositeUri>] <contributionURL> [-duris <uri,uri,...>]");
- out.println();
- out.println(" Starts a composite.");
- out.println(" The composite is added to the domain composite with semantics that correspond to the domain-level");
- out.println(" composite having an <include> statement that references the supplied composite. All of the composites");
- out.println(" components become top-level components and the component services become externally visible");
- out.println(" services (eg. they would be present in a WSDL description of the Domain).");
- out.println();
- out.println(" The second form of the start command starts in standalone mode not part of any SCA domain.");
- out.println();
- out.println(" Arguments (form1):");
- out.println(" curi - (required) the URI of an installed contribution");
- out.println(" compositeUri or contentURL - (required) either the URI of a composite within the contribution");
- out.println(" or a URL to an external composite file.");
- out.println(" Arguments (form2):");
- out.println(" name - (required) a name for the started composite/contribution");
- out.println(" compositeUri - (optional) the URI of a composite within the contribution");
- out.println(" contributionURL - (required) the URL to the contribution");
- out.println(" -duris <uri,uri,...> - (optional) specifies the URIs of contributions that are used to resolve the");
- out.println(" dependencies of the root contribution and other dependent contributions.");
- }
-
- void helpStarted() {
- out.println(" started [<curi> [<compositeUri>]]");
- out.println();
- out.println(" Shows the status of the Node, listing for each started composite, its");
- out.println(" contribution URI, the composite URI, and the composite QName.");
- out.println();
- out.println(" Arguments:");
- out.println(" curi - (optional) the URI of an installed contribution");
- out.println(" compositeUri - (optional) the URI of a composite");
- }
-
- void helpStatus() {
- out.println(" status");
- out.println();
- out.println(" Shows the status of the Shell including information on the known domains,");
- out.println(" installed contributions, and started composites");
- out.println();
- out.println(" Arguments:");
- out.println(" none");
- }
-
- void helpStop() {
- out.println(" stop [<curi> [<compositeUri>]]");
- out.println(" stop <name>");
- out.println();
- out.println(" Stops a domain or standalone node or individual composites and contributions in a Domain.");
- out.println(" If a composite URI is specified then the composite is removed from the Domain Level composite");
- out.println(" This means that the removal of the components, wires, services and references originally added");
- out.println(" to the domain level composite by the identified composite. If a contribution URI is specified");
- out.println(" without a composite URI then all deployed composites composites in the contribution are stopped.");
- out.println();
- out.println(" Arguments:");
- out.println(" curi - (required) the URI of an installed contribution");
- out.println(" compositeUri - (optional) the URI of a composite");
- out.println(" name - (required) the name of a standalon node or domain to stop");
- }
-
- void helpBye() {
- out.println(" bye");
- out.println();
- out.println(" All deployed composites are stopped and the Shell exists.");
- out.println();
- out.println(" Arguments:");
- out.println(" none");
- }
-
- void helpStartUp() {
- out.println(" Tuscany Shell StartUp Options ");
- out.println();
- out.println(" When starting the Tuscany Shell there are optional arguments that can configure the Shell.");
- out.println();
- out.println(" Arguments:");
- out.println(" <domainURI> (optional) the URI of the domain.");
- out.println(" When the domainURI is a simple string then the Shell starts a standalone");
- out.println(" Node using the string as the domain name or 'default' if no name is specified.");
- out.println(" When the domainURI starts with 'uri:' the Shell starts a distributed Node ");
- out.println(" and the URI can encode parameters to configure the domain as follows:");
- out.println(" uri:<domainName?key1=value1&key2=value2&...");
- out.println(" The keys are optional and some keys are:");
- out.println(" bind=ip[:port] - defines the local bind address and port, if the port is not specified it");
- out.println(" defaults 14820 and if that port in use it will try incrementing by one till a free port is found.");
- out.println(" multicast=groupip:port | off - defines if multicast discovery is used and if so what multicast IP group and port is used.");
- out.println(" It defaults to 224.5.12.10:51482. A value of 'off' means multicast is disabled.");
- out.println(" wka=ip[:port] - a comma separated list of ip address and port for remote nodes in");
- out.println(" the domain group when multicast is not available. The port defaults to 14820.");
- out.println(" userid= is the userid other nodes must use to connect to this domain group. The default is the default domain name.");
- out.println(" password= is the password other nodes must use to connect to this domain group. The default is 'tuscany'.");
- out.println();
- out.println(" -nojline (optional) use plain Java System.in/out instead of JLine");
- out.println(" (no tab completion or advanced line editing will be available)");
- }
-}
|