org.glassfish.deployment.admin.ListComponentsCommand Maven / Gradle / Ivy
The newest version!
/*
* Copyright (c) 2008, 2018 Oracle and/or its affiliates. All rights reserved.
*
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v. 2.0, which is available at
* http://www.eclipse.org/legal/epl-2.0.
*
* This Source Code may also be made available under the following Secondary
* Licenses when the conditions for such availability set forth in the
* Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
* version 2 with the GNU Classpath Exception, which is available at
* https://www.gnu.org/software/classpath/license.html.
*
* SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
*/
package org.glassfish.deployment.admin;
import javax.security.auth.Subject;
import org.glassfish.api.ActionReport;
import org.glassfish.api.admin.AdminCommand;
import org.glassfish.api.admin.AdminCommandContext;
import org.glassfish.api.admin.CommandLock;
import org.glassfish.api.admin.ExecuteOn;
import org.glassfish.api.admin.RuntimeType;
import org.glassfish.api.admin.ParameterMap;
import org.glassfish.api.admin.CommandRunner;
import org.glassfish.api.admin.RestEndpoint;
import org.glassfish.api.admin.RestEndpoints;
import org.glassfish.api.admin.RestParam;
import org.glassfish.api.Param;
import org.glassfish.api.I18n;
import org.glassfish.api.container.Sniffer;
import org.glassfish.internal.deployment.SnifferManager;
import org.glassfish.config.support.TargetType;
import org.glassfish.config.support.CommandTarget;
import org.jvnet.hk2.annotations.Service;
import com.sun.enterprise.config.serverbeans.*;
import com.sun.enterprise.util.LocalStringManagerImpl;
import jakarta.inject.Inject;
import org.glassfish.hk2.api.PerLookup;
import com.sun.enterprise.config.serverbeans.Module;
import java.util.*;
import org.glassfish.api.admin.AccessRequired;
import org.glassfish.api.admin.AccessRequired.AccessCheck;
import org.glassfish.api.admin.AdminCommandSecurity;
/**
* list-components command
*/
@Service(name="list-components")
@I18n("list.components")
@PerLookup
@CommandLock(CommandLock.LockType.NONE)
@ExecuteOn(value={RuntimeType.DAS})
@TargetType(value={CommandTarget.DOMAIN, CommandTarget.DAS, CommandTarget.STANDALONE_INSTANCE, CommandTarget.CLUSTER})
@RestEndpoints({
@RestEndpoint(configBean=Cluster.class,
opType=RestEndpoint.OpType.GET,
path="list-components",
description="list-components",
params={
@RestParam(name="target", value="$parent")
}),
@RestEndpoint(configBean=Domain.class,
opType=RestEndpoint.OpType.GET,
path="list-components",
description="list-components",
params={
@RestParam(name="target", value="$parent")
}),
@RestEndpoint(configBean=Server.class,
opType=RestEndpoint.OpType.GET,
path="list-components",
description="list-components",
params={
@RestParam(name="target", value="$parent")
})
})
public class ListComponentsCommand implements AdminCommand, AdminCommandSecurity.AccessCheckProvider {
@Param(optional=true)
String type = null;
@Param(primary=true, optional=true)
public String target = "server";
@Param(optional=true, defaultValue="false", name="long", shortName="l")
public Boolean long_opt = false;
@Param(optional=true, defaultValue="false", shortName="t")
public Boolean terse = false;
@Param(optional=true, defaultValue="false")
public Boolean subcomponents = false;
@Param(optional=true, defaultValue="false")
private Boolean resources = false;
private static String[] validTypes = new String[] {"application", "appclient", "connector", "ejb", "web", "webservice"};
@Inject
protected Domain domain;
@Inject
SnifferManager snifferManager;
@Inject
CommandRunner commandRunner;
private final List apps = new ArrayList();
@Override
public Collection getAccessChecks() {
final List accessChecks = new ArrayList();
/* Read access to the collection of applications. */
accessChecks.add(new AccessCheck(DeploymentCommandUtils.APPLICATION_RESOURCE_NAME, "read"));
/*
* Because the command displays detailed information about the matching
* apps, require read access to each app to be displayed.
*/
for (Application app : domain.getApplicationsInTarget(target)) {
if (!app.isLifecycleModule()) {
if (type == null || isApplicationOfThisType(app, type)) {
apps.add(app);
accessChecks.add(new AccessCheck(AccessRequired.Util.resourceNameFromConfigBeanProxy(app), "read"));
}
}
}
return accessChecks;
}
final private static LocalStringManagerImpl localStrings = new LocalStringManagerImpl(ListComponentsCommand.class);
public void execute(AdminCommandContext context) {
final ActionReport report = context.getActionReport();
final ActionReport subReport = report.addSubActionsReport();
ActionReport.MessagePart part = report.getTopMessagePart();
int numOfApplications = 0;
List rowList = new ArrayList();
if (type != null) {
List validTypeList = Arrays.asList(validTypes);
if (!validTypeList.contains(type)) {
report.setMessage(localStrings.getLocalString("list.components.invalid.type", "Invalid type option value."));
report.setActionExitCode(ActionReport.ExitCode.FAILURE);
return;
}
}
for (Application app : apps) {
String[] currentRow;
if( !terse && long_opt ){
currentRow = new String[]{ app.getName(),
getAppSnifferEngines(app, true),
getLongStatus(app) };
} else {
currentRow = new String[]{ app.getName(),
getAppSnifferEngines(app, true)};
}
part.addProperty(app.getName(),
getAppSnifferEngines(app, false));
rowList.add(currentRow);
numOfApplications++;
}
// Starting output formatting
int numCols = 2;
String[] headings = new String[]{"NAME", "TYPE", "STATUS"};
int longestValue[] = new int[numCols];
if ( !terse && long_opt ) {
numCols = 3;
longestValue = new int[] {headings[0].length(), headings[1].length(), headings[2].length() };
}
for (String v[] : rowList) {
for (int i = 0; i < v.length; i++) {
if (v[i].length() > longestValue[i]) {
longestValue[i] = v[i].length();
}
}
}
StringBuilder formattedLineBuf = new StringBuilder();
for (int i = 0; i < numCols; i++) {
longestValue[i] += 2;
formattedLineBuf.append("%-")
.append(longestValue[i])
.append("s");
}
String formattedLine = formattedLineBuf.toString();
if ( !terse ) {
if (rowList.isEmpty()) {
subReport.setMessage(localStrings.getLocalString(
DeployCommand.class,
"list.no.applications.deployed",
"No applications are deployed to this target {0}.",
new Object[] {this.target}));
part.setMessage(localStrings.getLocalString("list.components.no.elements.to.list", "Nothing to List."));
} else if ( long_opt ) {
ActionReport.MessagePart childPart = part.addChild();
childPart.setMessage(String.format(formattedLine, (Object[])headings ));
}
}
for (String v[] : rowList) {
StringBuilder sb = new StringBuilder();
ActionReport.MessagePart childPart = part.addChild();
sb.append(String.format(formattedLine, (Object[])v));
if(resources){
displayAppScopedResources(v[0], report, childPart, context.getSubject());
}
if (subcomponents) {
displaySubComponents(v[0], report, childPart, context.getSubject());
}
childPart.setMessage(sb.toString());
}
// Ending output formatting
report.setActionExitCode(ActionReport.ExitCode.SUCCESS);
}
private String getLongStatus(Application app) {
String message = "";
boolean isVersionEnabled = domain.isAppEnabledInTarget(app.getName(), target);
if ( isVersionEnabled ) {
message = localStrings.getLocalString("list.applications.verbose.enabled", "enabled");
} else {
message = localStrings.getLocalString("list.applications.verbose.disabled", "disabled");
}
return message;
}
/**
* check the type of application by comparing the sniffer engine.
* @param app - Application
* @param type - type of application
* @return true if application is of the specified type else return
* false.
*/
boolean isApplicationOfThisType(final Application app, String type) {
// do the type conversion to be compatible with v2 syntax
if (type.equals("application")) {
type = "ear";
} else if (type.equals("webservice")) {
type = "webservices";
}
List engineList = getAppEngines(app);
for (Engine engine : engineList) {
if (engine.getSniffer().equals(type)) {
return true;
}
}
return false;
}
/**
* return all user visible sniffer engines in an application.
* The return format is
* @param module - Application's module
* @return sniffer engines
*/
String getAppSnifferEngines(final Application app, final boolean format) {
return getSniffers(getAppEngines(app), format);
}
/**
* return all user visible sniffer engines in an application.
* The return format is
* @param module - Application's module
* @return sniffer engines
*/
String getSnifferEngines(final Module module, final boolean format) {
return getSniffers (module.getEngines(), format);
}
private String getSniffers(final List engineList,
final boolean format) {
Set snifferSet = new LinkedHashSet();
for (Engine engine : engineList) {
final String engType = engine.getSniffer();
if (displaySnifferEngine(engType)) {
snifferSet.add(engine.getSniffer());
}
}
StringBuffer se = new StringBuffer();
if (!snifferSet.isEmpty()) {
if (format) {
se.append("<");
}
for (String sniffer : snifferSet) {
se.append(sniffer + ", ");
}
//eliminate the last "," and end the list with ">"
if (se.length()>2) {
se.replace(se.length()-2, se.length(), (format)?">":"");
} else if (format) {
se.append(">");
}
}
return se.toString();
}
private List getAppEngines(final Application app) {
final List engineList = new ArrayList();
// first add application level engines
engineList.addAll(app.getEngine());
// now add module level engines
for (Module module: app.getModule()) {
engineList.addAll(module.getEngines());
}
return engineList;
}
/**
* check to see if Sniffer engine is to be visible by the user.
*
* @param engType - type of sniffer engine
* @return true if visible, else false.
*/
boolean displaySnifferEngine(String engType) {
final Sniffer sniffer = snifferManager.getSniffer(engType);
return sniffer.isUserVisible();
}
private void displayAppScopedResources(String applicationName, ActionReport report, ActionReport.MessagePart part,
final Subject subject) {
Application application = null;
List applications = domain.getApplicationsInTarget(target);
for (Application app : applications) {
if (app.getName().equals(applicationName)) {
application = app;
}
}
if (application != null) {
ActionReport subReport = report.addSubActionsReport();
CommandRunner.CommandInvocation inv = commandRunner.getCommandInvocation("_list-resources", subReport, subject);
final ParameterMap parameters = new ParameterMap();
parameters.add("appname", application.getName());
inv.parameters(parameters).execute();
ActionReport.MessagePart subPart = subReport.getTopMessagePart();
for (ActionReport.MessagePart cp: subPart.getChildren()) {
ActionReport.MessagePart resourcesChildPart = part.addChild();
resourcesChildPart.setMessage(cp.getMessage());
}
}
}
private void displaySubComponents(String appName, ActionReport report,
ActionReport.MessagePart part, final Subject subject) {
ActionReport subReport = report.addSubActionsReport();
CommandRunner.CommandInvocation inv = commandRunner.getCommandInvocation("list-sub-components", subReport, subject);
final ParameterMap parameters = new ParameterMap();
parameters.add("DEFAULT", appName);
parameters.add("terse", "true");
parameters.add("resources", resources.toString());
inv.parameters(parameters).execute();
ActionReport.MessagePart subPart = subReport.getTopMessagePart();
for (ActionReport.MessagePart childPart: subPart.getChildren()) {
ActionReport.MessagePart actualChildPart = part.addChild();
actualChildPart.setMessage(" " + childPart.getMessage());
for(ActionReport.MessagePart grandChildPart : childPart.getChildren()){
actualChildPart.addChild().setMessage(grandChildPart.getMessage());
}
}
}
}