001 /* 002 * Copyright (C) 2012 eXo Platform SAS. 003 * 004 * This is free software; you can redistribute it and/or modify it 005 * under the terms of the GNU Lesser General Public License as 006 * published by the Free Software Foundation; either version 2.1 of 007 * the License, or (at your option) any later version. 008 * 009 * This software is distributed in the hope that it will be useful, 010 * but WITHOUT ANY WARRANTY; without even the implied warranty of 011 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 012 * Lesser General Public License for more details. 013 * 014 * You should have received a copy of the GNU Lesser General Public 015 * License along with this software; if not, write to the Free 016 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 017 * 02110-1301 USA, or see the FSF site: http://www.fsf.org. 018 */ 019 020 package org.crsh.shell.impl.command; 021 022 import groovy.lang.Script; 023 import org.crsh.command.GroovyScriptCommand; 024 import org.crsh.command.NoSuchCommandException; 025 import org.crsh.command.ShellCommand; 026 import org.crsh.plugin.PluginContext; 027 import org.crsh.plugin.ResourceKind; 028 029 import java.security.Principal; 030 031 public class CRaSH { 032 033 034 /** . */ 035 final ClassManager<ShellCommand> commands; 036 037 /** . */ 038 final ClassManager<Script> lifecycles; 039 040 /** . */ 041 final PluginContext context; 042 043 /** 044 * Create a new CRaSH. 045 * 046 * @param context the plugin context 047 * @throws NullPointerException if the context argument is null 048 */ 049 public CRaSH(PluginContext context) throws NullPointerException { 050 this.context = context; 051 this.commands = new ClassManager<ShellCommand>(context, ResourceKind.COMMAND, ShellCommand.class, GroovyScriptCommand.class); 052 this.lifecycles = new ClassManager<Script>(context, ResourceKind.LIFECYCLE, Script.class, Script.class); 053 } 054 055 public CRaSHSession createSession(Principal user) { 056 return new CRaSHSession(this, user); 057 } 058 059 /** 060 * Returns the plugin context. 061 * 062 * @return the plugin context 063 */ 064 public PluginContext getContext() { 065 return context; 066 } 067 068 /** 069 * Attempt to obtain a command instance. Null is returned when such command does not exist. 070 * 071 * @param name the command name 072 * @return a command instance 073 * @throws org.crsh.command.NoSuchCommandException if an error occured preventing the command creation 074 * @throws NullPointerException if the name argument is null 075 */ 076 public ShellCommand getCommand(String name) throws NoSuchCommandException, NullPointerException { 077 return commands.getInstance(name); 078 } 079 }