• Home
• org.apache.karaf.tooling
• karaf-maven-plugin
• 4.2.8
• source code
• DocBookCommandHelpPrinter.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

org.apache.karaf.tooling.commands.DocBookCommandHelpPrinter Maven / Gradle / Ivy

/**
 * 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.karaf.tooling.commands;

import java.io.PrintStream;
import java.lang.reflect.Field;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;

import org.apache.karaf.shell.api.action.Action;
import org.apache.karaf.shell.api.action.Argument;
import org.apache.karaf.shell.api.action.Command;
import org.apache.karaf.shell.api.action.Option;
import org.apache.karaf.shell.impl.action.command.HelpOption;

/**
 * Prints documentation in docbook syntax
 */
public class DocBookCommandHelpPrinter extends AbstractCommandHelpPrinter {

    @Override
    public void printHelp(Action action, PrintStream out, boolean includeHelpOption) {
        Command command = action.getClass().getAnnotation(Command.class);
        Set options = new HashSet<>();
        List arguments = new ArrayList<>();
        Map argFields = new HashMap<>();
        Map optFields = new HashMap<>();
        for (Class type = action.getClass(); type != null; type = type.getSuperclass()) {
            for (Field field : type.getDeclaredFields()) {
                Option option = field.getAnnotation(Option.class);
                if (option != null) {
                    options.add(option);
                }

                Argument argument = field.getAnnotation(Argument.class);
                if (argument != null) {
                    argument = replaceDefaultArgument(field, argument);
                    argFields.put(argument, field);
                    int index = argument.index();
                    while (arguments.size() <= index) {
                        arguments.add(null);
                    }
                    if (arguments.get(index) != null) {
                        throw new IllegalArgumentException("Duplicate argument index: " + index + " on Action " + action.getClass().getName());
                    }
                    arguments.set(index, argument);
                }
            }
        }
        if (includeHelpOption)
            options.add(HelpOption.HELP);

        out.println("
");
        out.println("  ");
        out.println("  
");
        out.println("    ");
        out.println("    ");
        out.println(command.description());
        out.println("    ");
        out.println("  
");

        StringBuilder syntax = new StringBuilder();
        syntax.append(String.format("%s:%s", command.scope(), command.name()));
        if (options.size() > 0) {
            syntax.append(" [options]");
        }
        if (arguments.size() > 0) {
            syntax.append(' ');
            for (Argument argument : arguments) {
                syntax.append(String.format(argument.required() ? "%s " : "[%s] ", argument.name()));
            }
        }
        out.println("  
");
        out.println("    ");
        out.println("    ");
        out.println(syntax.toString());
        out.println("    ");
        out.println("  
");

        if (arguments.size() > 0) {
            out.println("  
");
            out.println("    ");
            out.println("    ");
            for (Argument argument : arguments) {
                out.println("    ");
                out.println("      " + argument.name() + "");
                String description = argument.description();
                if (!argument.required()) {
                    if (argument.valueToShowInHelp() != null && argument.valueToShowInHelp().length() != 0) {
                        if (Argument.DEFAULT_STRING.equals(argument.valueToShowInHelp())) {
                            Object o = getDefaultValue(action, argFields.get(argument));
                            String defaultValue = getDefaultValueString(o);
                            if (defaultValue != null) {
                                description += " (defaults to " + o.toString() + ")";
                            }
                        }
                    }
                }
                out.println("      " + description + "");
                out.println("    ");
            }

            out.println("    ");
            out.println("  
");
        }

        if (options.size() > 0) {
            out.println("  
");
            out.println("    ");
            out.println("    ");

            for (Option option : options) {
                String opt = option.name();
                String description = option.description();
                for (String alias : option.aliases()) {
                    opt += ", " + alias;
                }
                Object o = getDefaultValue(action, optFields.get(option));
                String defaultValue = getDefaultValueString(o);
                if (defaultValue != null) {
                    description += " (defaults to " + o.toString() + ")";
                }
                out.println("    ");
                out.println("      " + opt + "");
                out.println("      " + description + "");
                out.println("    ");
            }

            out.println("    ");
            out.println("  
");
        }

        if (command.detailedDescription().length() > 0) {
            out.println("  
");
            out.println("    ");
            out.println("    ");
            out.println(command.detailedDescription());
            out.println("    ");
            out.println("  
");
        }
        out.println("
");
    }

    @Override
    public void printOverview(Map> commands, PrintStream writer) {
        writer.println("");
        writer.println("  ");
        writer.println("  ");
        for (String key : commands.keySet()) {
            writer.println("  
");
            writer.println("    ");
            for (String cmd : commands.get(key)) {
                writer.println("    ");
            }
            writer.println("  
");
        }
        writer.println("");
    }

}