/* * CDDL HEADER START * * The contents of this file are subject to the terms of the * Common Development and Distribution License, Version 1.0 only * (the "License"). You may not use this file except in compliance * with the License. * * You can obtain a copy of the license at * trunk/opends/resource/legal-notices/OpenDS.LICENSE * or https://OpenDS.dev.java.net/OpenDS.LICENSE. * See the License for the specific language governing permissions * and limitations under the License. * * When distributing Covered Code, include this CDDL HEADER in each * file and include the License file at * trunk/opends/resource/legal-notices/OpenDS.LICENSE. If applicable, * add the following below this CDDL HEADER, with the fields enclosed * by brackets "[]" replaced with your own identifying information: * Portions Copyright [yyyy] [name of copyright owner] * * CDDL HEADER END * * * Portions Copyright 2007 Sun Microsystems, Inc. */ package org.opends.server.tools.dsconfig; import static org.opends.server.messages.MessageHandler.*; import static org.opends.server.messages.ToolMessages.*; import java.io.PrintStream; import java.util.List; import java.util.Set; import java.util.SortedMap; import java.util.SortedSet; import java.util.TreeMap; import org.opends.server.admin.DefinitionDecodingException; import org.opends.server.admin.InstantiableRelationDefinition; import org.opends.server.admin.ManagedObjectDefinition; import org.opends.server.admin.ManagedObjectNotFoundException; import org.opends.server.admin.ManagedObjectPath; import org.opends.server.admin.OptionalRelationDefinition; import org.opends.server.admin.PropertyDefinition; import org.opends.server.admin.RelationDefinition; import org.opends.server.admin.client.AuthorizationException; import org.opends.server.admin.client.CommunicationException; import org.opends.server.admin.client.ConcurrentModificationException; import org.opends.server.admin.client.ManagedObject; import org.opends.server.admin.client.ManagedObjectDecodingException; import org.opends.server.admin.client.ManagementContext; import org.opends.server.protocols.ldap.LDAPResultCode; import org.opends.server.tools.ClientException; import org.opends.server.util.args.ArgumentException; import org.opends.server.util.args.StringArgument; import org.opends.server.util.args.SubCommand; import org.opends.server.util.args.SubCommandArgumentParser; import org.opends.server.util.table.TableBuilder; import org.opends.server.util.table.TablePrinter; import org.opends.server.util.table.TextTablePrinter; /** * A sub-command handler which is used to list existing managed * objects. *

* This sub-command implements the various list-xxx sub-commands. */ final class ListSubCommandHandler extends SubCommandHandler { /** * Creates a new list-xxx sub-command for an instantiable relation. * * @param parser * The sub-command argument parser. * @param p * The parent managed object path. * @param r * The instantiable relation. * @return Returns the new list-xxx sub-command. * @throws ArgumentException * If the sub-command could not be created successfully. */ public static ListSubCommandHandler create(SubCommandArgumentParser parser, ManagedObjectPath p, InstantiableRelationDefinition r) throws ArgumentException { return new ListSubCommandHandler(parser, p, r, r.getPluralName(), r .getUserFriendlyPluralName()); } /** * Creates a new list-xxx sub-command for an optional relation. * * @param parser * The sub-command argument parser. * @param p * The parent managed object path. * @param r * The optional relation. * @return Returns the new list-xxx sub-command. * @throws ArgumentException * If the sub-command could not be created successfully. */ public static ListSubCommandHandler create(SubCommandArgumentParser parser, ManagedObjectPath p, OptionalRelationDefinition r) throws ArgumentException { return new ListSubCommandHandler(parser, p, r, r.getName(), r .getUserFriendlyName()); } // The sub-commands naming arguments. private final List namingArgs; // The path of the parent managed object. private final ManagedObjectPath path; // The relation which should be listed. private final RelationDefinition relation; // The sub-command associated with this handler. private final SubCommand subCommand; // Private constructor. private ListSubCommandHandler(SubCommandArgumentParser parser, ManagedObjectPath p, RelationDefinition r, String rname, String rufn) throws ArgumentException { this.path = p; this.relation = r; // Create the sub-command. String name = "list-" + rname; int descriptionID = MSGID_DSCFG_DESCRIPTION_SUBCMD_LIST; this.subCommand = new SubCommand(parser, name, false, 0, 0, null, descriptionID, rufn); // Create the naming arguments. this.namingArgs = createNamingArgs(subCommand, path); // Register arguments. registerPropertyNameArgument(this.subCommand); registerUnitSizeArgument(this.subCommand); registerUnitTimeArgument(this.subCommand); // Register the tags associated with the child managed objects. addTags(relation.getChildDefinition().getAllTags()); } /** * {@inheritDoc} */ @Override public SubCommand getSubCommand() { return subCommand; } /** * {@inheritDoc} */ @Override public int run(DSConfig app, PrintStream out, PrintStream err) throws ArgumentException, ClientException { // Get the property names. Set propertyNames = getPropertyNames(); if (propertyNames.isEmpty()) { // Use a default set of properties. propertyNames = CLIProfile.getInstance().getDefaultListPropertyNames( relation); } PropertyValuePrinter valuePrinter = new PropertyValuePrinter(getSizeUnit(), getTimeUnit(), app.isScriptFriendly()); // Get the naming argument values. List names = getNamingArgValues(namingArgs); String ufn; if (relation instanceof InstantiableRelationDefinition) { InstantiableRelationDefinition irelation = (InstantiableRelationDefinition) relation; ufn = irelation.getUserFriendlyPluralName(); } else { ufn = relation.getUserFriendlyName(); } // List the children. ManagementContext context = app.getManagementContext(); ManagedObject parent; try { parent = getManagedObject(context, path, names); } catch (AuthorizationException e) { int msgID = MSGID_DSCFG_ERROR_LIST_AUTHZ; String msg = getMessage(msgID, ufn); throw new ClientException(LDAPResultCode.INSUFFICIENT_ACCESS_RIGHTS, msgID, msg); } catch (DefinitionDecodingException e) { int msgID = MSGID_DSCFG_ERROR_GET_PARENT_DDE; ufn = path.getManagedObjectDefinition().getUserFriendlyName(); String msg = getMessage(msgID, ufn, ufn, ufn); throw new ClientException(LDAPResultCode.OPERATIONS_ERROR, msgID, msg); } catch (ManagedObjectDecodingException e) { int msgID = MSGID_DSCFG_ERROR_GET_PARENT_MODE; ufn = path.getManagedObjectDefinition().getUserFriendlyName(); String msg = getMessage(msgID, ufn); throw new ClientException(LDAPResultCode.OPERATIONS_ERROR, msgID, msg); } catch (CommunicationException e) { int msgID = MSGID_DSCFG_ERROR_LIST_CE; String msg = getMessage(msgID, ufn, e.getMessage()); throw new ClientException(LDAPResultCode.CLIENT_SIDE_SERVER_DOWN, msgID, msg); } catch (ConcurrentModificationException e) { int msgID = MSGID_DSCFG_ERROR_LIST_CME; String msg = getMessage(msgID, ufn); throw new ClientException(LDAPResultCode.CONSTRAINT_VIOLATION, msgID, msg); } catch (ManagedObjectNotFoundException e) { int msgID = MSGID_DSCFG_ERROR_GET_PARENT_MONFE; ufn = path.getManagedObjectDefinition().getUserFriendlyName(); String msg = getMessage(msgID, ufn); throw new ClientException(LDAPResultCode.NO_SUCH_OBJECT, msgID, msg); } SortedMap> children = new TreeMap>(); if (relation instanceof InstantiableRelationDefinition) { InstantiableRelationDefinition irelation = (InstantiableRelationDefinition) relation; try { for (String s : parent.listChildren(irelation)) { try { children.put(s, parent.getChild(irelation, s)); } catch (ManagedObjectNotFoundException e) { // Ignore - as it's been removed since we did the list. } } } catch (DefinitionDecodingException e) { // FIXME: just output this as a warnings (incl. the name) but // continue. int msgID = MSGID_DSCFG_ERROR_LIST_DDE; String msg = getMessage(msgID, ufn, ufn, ufn); throw new ClientException(LDAPResultCode.OPERATIONS_ERROR, msgID, msg); } catch (ManagedObjectDecodingException e) { // FIXME: just output this as a warnings (incl. the name) but // continue. int msgID = MSGID_DSCFG_ERROR_LIST_MODE; String msg = getMessage(msgID, ufn); throw new ClientException(LDAPResultCode.OPERATIONS_ERROR, msgID, msg); } catch (AuthorizationException e) { int msgID = MSGID_DSCFG_ERROR_LIST_AUTHZ; String msg = getMessage(msgID, ufn); throw new ClientException(LDAPResultCode.INSUFFICIENT_ACCESS_RIGHTS, msgID, msg); } catch (ConcurrentModificationException e) { int msgID = MSGID_DSCFG_ERROR_LIST_CME; String msg = getMessage(msgID, ufn); throw new ClientException(LDAPResultCode.CONSTRAINT_VIOLATION, msgID, msg); } catch (CommunicationException e) { int msgID = MSGID_DSCFG_ERROR_LIST_CE; String msg = getMessage(msgID, ufn, e.getMessage()); throw new ClientException(LDAPResultCode.CLIENT_SIDE_SERVER_DOWN, msgID, msg); } } else if (relation instanceof OptionalRelationDefinition) { OptionalRelationDefinition orelation = (OptionalRelationDefinition) relation; try { if (parent.hasChild(orelation)) { ManagedObject child = parent.getChild(orelation); children.put(child.getManagedObjectDefinition().getName(), child); } else { // Indicate that the managed object does not exist. throw new ManagedObjectNotFoundException(); } } catch (AuthorizationException e) { int msgID = MSGID_DSCFG_ERROR_LIST_AUTHZ; String msg = getMessage(msgID, ufn); throw new ClientException(LDAPResultCode.INSUFFICIENT_ACCESS_RIGHTS, msgID, msg); } catch (DefinitionDecodingException e) { int msgID = MSGID_DSCFG_ERROR_LIST_DDE; String msg = getMessage(msgID, ufn, ufn, ufn); throw new ClientException(LDAPResultCode.OPERATIONS_ERROR, msgID, msg); } catch (ManagedObjectDecodingException e) { int msgID = MSGID_DSCFG_ERROR_LIST_MODE; String msg = getMessage(msgID, ufn); throw new ClientException(LDAPResultCode.OPERATIONS_ERROR, msgID, msg); } catch (ConcurrentModificationException e) { int msgID = MSGID_DSCFG_ERROR_LIST_CME; String msg = getMessage(msgID, ufn); throw new ClientException(LDAPResultCode.CONSTRAINT_VIOLATION, msgID, msg); } catch (CommunicationException e) { int msgID = MSGID_DSCFG_ERROR_LIST_CE; String msg = getMessage(msgID, ufn, e.getMessage()); throw new ClientException(LDAPResultCode.CLIENT_SIDE_SERVER_DOWN, msgID, msg); } catch (ManagedObjectNotFoundException e) { int msgID = MSGID_DSCFG_ERROR_LIST_MONFE; String msg = getMessage(msgID, ufn); throw new ClientException(LDAPResultCode.NO_SUCH_OBJECT, msgID, msg); } } // Output the results. if (app.isScriptFriendly()) { // Output just the names of the children. for (String name : children.keySet()) { out.println(name); } } else { // Create a table of their properties. TableBuilder builder = new TableBuilder(); builder.appendHeading(relation.getUserFriendlyName()); builder .appendHeading(getMessage(MSGID_DSCFG_HEADING_MANAGED_OBJECT_TYPE)); if (!propertyNames.isEmpty()) { } for (String propertyName : propertyNames) { builder.appendHeading(propertyName); } builder.addSortKey(0); String baseType = relation.getName(); String typeSuffix = "-" + baseType; for (String name : children.keySet()) { ManagedObject child = children.get(name); ManagedObjectDefinition d = child.getManagedObjectDefinition(); // First output the name. builder.startRow(); builder.appendCell(name); // Output the managed object type in the form used in // create-xxx commands. String childType = d.getName(); if (baseType.equals(childType)) { builder.appendCell("generic"); } else if (childType.endsWith(typeSuffix)) { builder.appendCell(childType.substring(0, childType.length() - typeSuffix.length())); } else { builder.appendCell(childType); } // Now any requested properties. for (String propertyName : propertyNames) { try { PropertyDefinition pd = d.getPropertyDefinition(propertyName); displayProperty(app, builder, child, pd, valuePrinter); } catch (IllegalArgumentException e) { // Assume this child managed object does not support this // property. if (app.isScriptFriendly()) { builder.appendCell(); } else { builder.appendCell("-"); } } } } if (app.isScriptFriendly()) { TablePrinter printer = createScriptFriendlyTablePrinter(out); builder.print(printer); } else { TextTablePrinter printer = new TextTablePrinter(out); printer.setColumnSeparator(":"); builder.print(printer); } } return 0; } // Display the set of values associated with a property. private void displayProperty(DSConfig app, TableBuilder builder, ManagedObject mo, PropertyDefinition pd, PropertyValuePrinter valuePrinter) { SortedSet values = mo.getPropertyValues(pd); if (values.isEmpty()) { if (app.isScriptFriendly()) { builder.appendCell(); } else { builder.appendCell("-"); } } else { StringBuilder sb = new StringBuilder(); boolean isFirst = true; for (T value : values) { if (!isFirst) { sb.append(", "); } sb.append(valuePrinter.print(pd, value)); isFirst = false; } builder.appendCell(sb.toString()); } } }