All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.apache.sis.console.AboutSC Maven / Gradle / Ivy

There is a newer version: 1.4
Show newest version
/*
 * 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.sis.console;

import java.util.EnumSet;
import java.io.IOException;
import java.rmi.registry.Registry;
import javax.management.JMX;
import javax.management.ObjectName;
import javax.management.MBeanServerConnection;
import javax.management.remote.JMXServiceURL;
import javax.management.remote.JMXConnector;
import javax.management.remote.JMXConnectorFactory;
import org.apache.sis.setup.About;
import org.apache.sis.util.Version;
import org.apache.sis.util.resources.Errors;
import org.apache.sis.util.resources.Vocabulary;
import org.apache.sis.internal.system.Supervisor;
import org.apache.sis.internal.system.SupervisorMBean;


/**
 * The "about" subcommand.
 * By default this sub-command prints all information except the {@link About#LIBRARIES} section,
 * because the later is considered too verbose. Available options are:
 *
 * 
    *
  • {@code --brief}: prints only Apache SIS version number.
  • *
  • {@code --verbose}: prints all information including the libraries.
  • *
* * {@section About SIS installation on a remote machine} * This sub-command can provide information about SIS installation on a remote machine, * provided that remote access has been enabled at the Java Virtual Machine startup time. * See {@link org.apache.sis.console} package javadoc for more information. * * @author Martin Desruisseaux (Geomatys) * @since 0.3 * @version 0.4 * @module */ final class AboutSC extends SubCommand { /** * Creates the {@code "about"} sub-command. */ AboutSC(final int commandIndex, final String... args) throws InvalidOptionException { super(commandIndex, args, EnumSet.of(Option.LOCALE, Option.TIMEZONE, Option.ENCODING, Option.BRIEF, Option.VERBOSE, Option.HELP)); } /** * Prints the information to the output stream. */ @Override public int run() throws Exception { /* * Check the number of arguments, which can be 0 or 1. If present, * the argument is the name and port number of a remote machine. * * In the current implementation, the --brief option is supported only on the local machine. */ final boolean brief = options.containsKey(Option.BRIEF); if (hasUnexpectedFileCount(0, brief ? 0 : 1)) { return Command.INVALID_ARGUMENT_EXIT_CODE; } final String configuration; if (brief) { configuration = Vocabulary.getResources(locale).getString( Vocabulary.Keys.Version_2, "Apache SIS", Version.SIS); } else { if (files.isEmpty()) { /* * Provide information about the local SIS installation. */ final EnumSet sections = EnumSet.allOf(About.class); if (!options.containsKey(Option.VERBOSE)) { sections.remove(About.LIBRARIES); } configuration = About.configuration(sections, locale, timezone).toString(); } else { /* * Provide information about a remote SIS installation. Those information are accessible * only if explicitely enabled at JVM startup time. * * Tutorial: http://docs.oracle.com/javase/tutorial/jmx/remote/custom.html */ final String path = toRemoveURL(files.get(0)); try { final JMXServiceURL url = new JMXServiceURL(path); final JMXConnector jmxc = JMXConnectorFactory.connect(url); try { final MBeanServerConnection mbsc = jmxc.getMBeanServerConnection(); final SupervisorMBean bean = JMX.newMBeanProxy(mbsc, new ObjectName(Supervisor.NAME), SupervisorMBean.class); configuration = bean.configuration().toString(); } finally { jmxc.close(); } } catch (IOException e) { error(Errors.format(Errors.Keys.CanNotConnectTo_1, path), e); return Command.IO_EXCEPTION_EXIT_CODE; } } } out.println(configuration); out.flush(); return 0; } /** * Creates a {@code "service:jmx:rmi:///jndi/rmi://host:port/jmxrmi"} URL for the given host name. * The host name can optionally be followed by a port number. */ static String toRemoveURL(final String host) { final StringBuilder buffer = new StringBuilder(60).append("service:jmx:rmi:///jndi/rmi://") .append(host, host.regionMatches(true, 0, "localhost", 0, 9) ? 9 : 0, host.length()); if (host.lastIndexOf(':') < 0) { buffer.append(':').append(Registry.REGISTRY_PORT); } return buffer.append("/jmxrmi").toString(); } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy