org.eclipse.equinox.internal.app.AppCommands Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of aspectjtools Show documentation
Show all versions of aspectjtools Show documentation
AspectJ tools most notably contains the AspectJ compiler (AJC). AJC applies aspects to Java classes during
compilation, fully replacing Javac for plain Java classes and also compiling native AspectJ or annotation-based
@AspectJ syntax. Furthermore, AJC can weave aspects into existing class files in a post-compile binary weaving step.
This library is a superset of AspectJ weaver and hence also of AspectJ runtime.
/*******************************************************************************
* Copyright (c) 2005, 2018 IBM Corporation and others.
*
* This program and the accompanying materials
* are made available under the terms of the Eclipse Public License 2.0
* which accompanies this distribution, and is available at
* https://www.eclipse.org/legal/epl-2.0/
*
* SPDX-License-Identifier: EPL-2.0
*
* Contributors:
* IBM Corporation - initial API and implementation
* Alex Blewitt (bug 196071)
*******************************************************************************/
package org.eclipse.equinox.internal.app;
import java.util.*;
import java.util.Map.Entry;
import org.eclipse.equinox.app.IApplicationContext;
import org.eclipse.osgi.framework.console.CommandInterpreter;
import org.eclipse.osgi.framework.console.CommandProvider;
import org.osgi.framework.*;
import org.osgi.service.application.*;
import org.osgi.util.tracker.ServiceTracker;
public class AppCommands implements CommandProvider {
private final static String LAUNCHABLE_APP_FILTER = "(&(application.locked=false)(application.launchable=true)(application.visible=true))"; //$NON-NLS-1$
private final static String ACTIVE_APP_FILTER = "(!(application.state=STOPPING))"; //$NON-NLS-1$
private final static String LOCKED_APP_FILTER = "(application.locked=true)"; //$NON-NLS-1$
private final static String NEW_LINE = "\r\n"; //$NON-NLS-1$
private final static String TAB = "\t"; //$NON-NLS-1$
// holds the mappings from command name to command arguments and command description
private Map commandsHelp = null;
private static AppCommands instance;
private BundleContext context;
private ServiceTracker applicationDescriptors;
private ServiceTracker applicationHandles;
private ServiceTracker scheduledApplications;
private Filter launchableApp;
private Filter activeApp;
private Filter lockedApp;
private ServiceRegistration providerRegistration;
static synchronized void create(BundleContext context) {
if (instance != null)
return;
instance = new AppCommands();
instance.start(context);
}
static synchronized void destroy(BundleContext context) {
if (instance == null)
return;
instance.stop(context);
instance = null;
}
protected AppCommands() {
// empty
}
public void start(BundleContext ctx) {
this.context = ctx;
try {
applicationDescriptors = new ServiceTracker(ctx, ApplicationDescriptor.class.getName(), null);
applicationDescriptors.open();
applicationHandles = new ServiceTracker(ctx, ApplicationHandle.class.getName(), null);
applicationHandles.open();
scheduledApplications = new ServiceTracker(ctx, ScheduledApplication.class.getName(), null);
scheduledApplications.open();
launchableApp = ctx.createFilter(LAUNCHABLE_APP_FILTER);
activeApp = ctx.createFilter(ACTIVE_APP_FILTER);
lockedApp = ctx.createFilter(LOCKED_APP_FILTER);
providerRegistration = ctx.registerService(CommandProvider.class.getName(), this, null);
} catch (InvalidSyntaxException e) {
// should not happen.
}
}
public void stop(BundleContext ctx) {
providerRegistration.unregister();
if (applicationDescriptors != null)
applicationDescriptors.close();
if (applicationHandles != null)
applicationHandles.close();
if (scheduledApplications != null)
scheduledApplications.close();
}
@Override
public String getHelp() {
return getHelp(null);
}
/*
* This method either returns the help message for a particular command,
* or returns the help messages for all commands (if commandName is null)
*/
private String getHelp(String commandName) {
StringBuffer sb = new StringBuffer();
if (commandsHelp == null) {
initializeCommandsHelp();
}
if (commandName != null) {
if (commandsHelp.containsKey(commandName)) {
addCommand(commandName, commandsHelp.get(commandName), sb);
}
return sb.toString();
}
addHeader(Messages.console_help_app_commands_header, sb);
for (Entry entry : commandsHelp.entrySet()) {
String command = entry.getKey();
String[] attributes = entry.getValue();
addCommand(command, attributes, sb);
}
return sb.toString();
}
private void initializeCommandsHelp() {
commandsHelp = new LinkedHashMap<>();
commandsHelp.put("activeApps", new String[] {Messages.console_help_activeapps_description}); //$NON-NLS-1$
commandsHelp.put("apps", new String[] {Messages.console_help_apps_description}); //$NON-NLS-1$
commandsHelp.put("lockApp", new String[] {Messages.console_help_arguments, Messages.console_help_lockapp_description}); //$NON-NLS-1$
commandsHelp.put("schedApp", new String[] {Messages.console_help_schedapp_arguments, Messages.console_help_schedapp_description}); //$NON-NLS-1$
commandsHelp.put("startApp", new String[] {Messages.console_help_arguments, Messages.console_help_startapp_description}); //$NON-NLS-1$
commandsHelp.put("stopApp", new String[] {Messages.console_help_arguments, Messages.console_help_stopapp_description}); //$NON-NLS-1$
commandsHelp.put("unlockApp", new String[] {Messages.console_help_arguments, Messages.console_help_unlockapp_description}); //$NON-NLS-1$
commandsHelp.put("unschedApp", new String[] {Messages.console_help_arguments, Messages.console_help_unschedapp_description}); //$NON-NLS-1$
}
/** Private helper method for getHelp. Formats the help headers. */
private void addHeader(String header, StringBuffer help) {
help.append("---"); //$NON-NLS-1$
help.append(header);
help.append("---"); //$NON-NLS-1$
help.append(NEW_LINE);
}
/** Private helper method for getHelp. Formats the command descriptions. */
private void addCommand(String command, String description, StringBuffer help) {
help.append(TAB);
help.append(command);
help.append(" - "); //$NON-NLS-1$
help.append(description);
help.append(NEW_LINE);
}
/** Private helper method for getHelp. Formats the command descriptions with command arguments. */
private void addCommand(String command, String parameters, String description, StringBuffer help) {
help.append(TAB);
help.append(command);
help.append(" "); //$NON-NLS-1$
help.append(parameters);
help.append(" - "); //$NON-NLS-1$
help.append(description);
help.append(NEW_LINE);
}
/** Private helper method for getHelp. According to its arguments chooses which one of the above addCommand methods to use. */
private void addCommand(String command, String[] attributes, StringBuffer help) {
if (attributes.length == 1) {
addCommand(command, attributes[0], help);
} else if (attributes.length == 2) {
addCommand(command, attributes[0], attributes[1], help);
}
}
private Dictionary getServiceProps(ServiceReference ref) {
String[] keys = ref.getPropertyKeys();
Hashtable props = new Hashtable<>(keys.length);
for (String key : keys) {
props.put(key, ref.getProperty(key));
}
return props;
}
public void _apps(CommandInterpreter intp) {
ServiceReference[] apps = applicationDescriptors.getServiceReferences();
if (apps == null) {
intp.println("No applications found."); //$NON-NLS-1$
return;
}
for (ServiceReference app : apps) {
String application = (String) app.getProperty(ApplicationDescriptor.APPLICATION_PID);
intp.print(application);
if (getApplication(applicationHandles.getServiceReferences(), application, ApplicationHandle.APPLICATION_DESCRIPTOR, true) != null)
intp.print(" [running]"); //$NON-NLS-1$
if (getApplication(scheduledApplications.getServiceReferences(), application, ScheduledApplication.APPLICATION_PID, true) != null)
intp.print(" [scheduled]"); //$NON-NLS-1$
if (!launchableApp.match(getServiceProps(app))) {
intp.print(" [not launchable]"); //$NON-NLS-1$
} else {
intp.print(" [launchable]"); //$NON-NLS-1$
}
if (lockedApp.match(getServiceProps(app))) {
intp.print(" [locked]"); //$NON-NLS-1$
}
intp.println();
}
}
public void _activeApps(CommandInterpreter intp) {
ServiceReference[] active = applicationHandles.getServiceReferences();
if (active == null) {
intp.println("No active applications found"); //$NON-NLS-1$
return;
}
for (ServiceReference r : active) {
intp.print(r.getProperty(ApplicationHandle.APPLICATION_PID));
intp.print(" ["); //$NON-NLS-1$
intp.print(activeApp.match(getServiceProps(r)) ? "running" : "stopping"); //$NON-NLS-1$ //$NON-NLS-2$
intp.println("]"); //$NON-NLS-1$
}
}
private ServiceReference getApplication(ServiceReference[] apps, String targetId, String idKey, boolean perfectMatch) {
if (apps == null || targetId == null)
return null;
ServiceReference result = null;
boolean ambigous = false;
for (ServiceReference app : apps) {
String id = (String) app.getProperty(idKey);
if (targetId.equals(id)) {
return app; // always return a perfect match
}
if (perfectMatch)
continue;
if (id.contains(targetId)) {
if (result != null)
ambigous = true;
result = app;
}
}
return ambigous ? null : result;
}
public void _startApp(CommandInterpreter intp) throws Exception {
String appId = intp.nextArgument();
ServiceReference application = getApplication(applicationDescriptors.getServiceReferences(), appId, ApplicationDescriptor.APPLICATION_PID, false);
if (application == null)
intp.println("\"" + appId + "\" does not exist or is ambigous."); //$NON-NLS-1$ //$NON-NLS-2$
else {
ArrayList argList = new ArrayList<>();
String arg = null;
while ((arg = intp.nextArgument()) != null)
argList.add(arg);
String[] args = argList.size() == 0 ? null : (String[]) argList.toArray(new String[argList.size()]);
try {
HashMap launchArgs = new HashMap<>(1);
if (args != null)
launchArgs.put(IApplicationContext.APPLICATION_ARGS, args);
ApplicationDescriptor appDesc = (context. getService(application));
ApplicationHandle handle = appDesc.launch(launchArgs);
intp.println("Launched application instance: " + handle.getInstanceId()); //$NON-NLS-1$
} finally {
context.ungetService(application);
}
return;
}
}
public void _stopApp(CommandInterpreter intp) throws Exception {
String appId = intp.nextArgument();
// first search for the application instance id
ServiceReference application = getApplication(applicationHandles.getServiceReferences(), appId, ApplicationHandle.APPLICATION_PID, false);
if (application == null)
application = getApplication(applicationHandles.getServiceReferences(), appId, ApplicationHandle.APPLICATION_DESCRIPTOR, false);
if (application == null)
intp.println("\"" + appId + "\" does not exist, is not running or is ambigous."); //$NON-NLS-1$ //$NON-NLS-2$
else {
if (activeApp.match(getServiceProps(application))) {
try {
ApplicationHandle appHandle = (ApplicationHandle) context.getService(application);
appHandle.destroy();
intp.println("Stopped application instance: " + appHandle.getInstanceId()); //$NON-NLS-1$
} finally {
context.ungetService(application);
}
} else {
intp.println("Application instance is already stopping: " + application.getProperty(ApplicationHandle.APPLICATION_PID)); //$NON-NLS-1$
}
return;
}
}
public void _lockApp(CommandInterpreter intp) throws Exception {
String appId = intp.nextArgument();
ServiceReference application = getApplication(applicationDescriptors.getServiceReferences(), appId, ApplicationDescriptor.APPLICATION_PID, false);
if (application == null)
intp.println("\"" + appId + "\" does not exist or is ambigous."); //$NON-NLS-1$ //$NON-NLS-2$
else {
try {
ApplicationDescriptor appDesc = (ApplicationDescriptor) context.getService(application);
appDesc.lock();
intp.println("Locked application: " + appDesc.getApplicationId()); //$NON-NLS-1$
} finally {
context.ungetService(application);
}
return;
}
}
public void _unlockApp(CommandInterpreter intp) throws Exception {
String appId = intp.nextArgument();
ServiceReference application = getApplication(applicationDescriptors.getServiceReferences(), appId, ApplicationDescriptor.APPLICATION_PID, false);
if (application == null)
intp.println("\"" + appId + "\" does not exist or is ambigous."); //$NON-NLS-1$ //$NON-NLS-2$
else {
try {
ApplicationDescriptor appDesc = (ApplicationDescriptor) context.getService(application);
appDesc.unlock();
intp.println("Unlocked application: " + appDesc.getApplicationId()); //$NON-NLS-1$
} finally {
context.ungetService(application);
}
return;
}
}
public void _schedApp(CommandInterpreter intp) throws Exception {
String appId = intp.nextArgument();
ServiceReference application = getApplication(applicationDescriptors.getServiceReferences(), appId, ApplicationDescriptor.APPLICATION_PID, false);
if (application == null)
intp.println("\"" + appId + "\" does not exist or is ambigous."); //$NON-NLS-1$ //$NON-NLS-2$
else {
try {
ApplicationDescriptor appDesc = (ApplicationDescriptor) context.getService(application);
String filter = intp.nextArgument();
boolean recure = Boolean.valueOf(intp.nextArgument()).booleanValue();
appDesc.schedule(null, null, "org/osgi/application/timer", filter, recure); //$NON-NLS-1$
intp.println("Scheduled application: " + appDesc.getApplicationId()); //$NON-NLS-1$
} finally {
context.ungetService(application);
}
return;
}
}
public void _unschedApp(CommandInterpreter intp) throws Exception {
String appId = intp.nextArgument();
ServiceReference application = getApplication(scheduledApplications.getServiceReferences(), appId, ScheduledApplication.APPLICATION_PID, false);
if (application == null)
intp.println("\"" + appId + "\" does not exist or is ambigous."); //$NON-NLS-1$ //$NON-NLS-2$
else {
try {
ScheduledApplication schedApp = (ScheduledApplication) context.getService(application);
schedApp.remove();
intp.println("Unscheduled application: " + application.getProperty(ApplicationDescriptor.APPLICATION_PID)); //$NON-NLS-1$
} finally {
context.ungetService(application);
}
}
}
/**
* Handles the help command
*
* @param intp
* @return description for a particular command or false if there is no command with the specified name
*/
public Object _help(CommandInterpreter intp) {
String commandName = intp.nextArgument();
if (commandName == null) {
return Boolean.FALSE;
}
String help = getHelp(commandName);
if (help.length() > 0) {
return help;
}
return Boolean.FALSE;
}
}