/* JSPWiki - a JSP-based WikiWiki clone. 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 com.ecyrd.jspwiki.ui; import com.ecyrd.jspwiki.TextUtil; /** * Abstract, immutable Command implementation class. All of the fields in this * class are final. This class is thread-safe. * @author Andrew Jaquith * @since 2.4.22 */ public abstract class AbstractCommand implements Command { private static final Command[] ALL_COMMANDS = new Command[] { PageCommand.ATTACH, PageCommand.COMMENT, PageCommand.CONFLICT, PageCommand.DELETE, PageCommand.DIFF, PageCommand.EDIT, PageCommand.INFO, PageCommand.NONE, PageCommand.OTHER, PageCommand.PREVIEW, PageCommand.RENAME, PageCommand.RSS, PageCommand.UPLOAD, PageCommand.VIEW, GroupCommand.DELETE_GROUP, GroupCommand.EDIT_GROUP, GroupCommand.VIEW_GROUP, WikiCommand.CREATE_GROUP, WikiCommand.ERROR, WikiCommand.FIND, WikiCommand.INSTALL, WikiCommand.LOGIN, WikiCommand.LOGOUT, WikiCommand.MESSAGE, WikiCommand.PREFS, WikiCommand.WORKFLOW, WikiCommand.ADMIN, RedirectCommand.REDIRECT }; private static final String HTTPS = "HTTPS://"; private static final String HTTP = "HTTP://"; private final String m_jsp; private final String m_jspFriendlyName; private final String m_urlPattern; private final String m_requestContext; private final String m_contentTemplate; private final Object m_target; /** * Constructs a new Command with a specified wiki context, URL pattern, * content template and target. The URL pattern is used to derive * the JSP; if it is a "local" JSP (that is, it does not contain * the http:// or https:// prefixes), * then the JSP will be a cleansed version of the URL pattern; * symbols (such as %u) will removed. If it the supplied * URL pattern points to a non-local destination, the JSP will be set * to the value supplied, unmodified. * @param requestContext the request context * @param urlPattern the URL pattern * @param contentTemplate the content template; may be null * @param target the target of the command, such as a WikiPage; may be * null * @throws IllegalArgumentException if the request content or URL pattern is * null */ protected AbstractCommand( String requestContext, String urlPattern, String contentTemplate, Object target ) { if ( requestContext == null || urlPattern == null ) { throw new IllegalArgumentException( "Request context, URL pattern and type must not be null." ); } m_requestContext = requestContext; if ( urlPattern.toUpperCase().startsWith( HTTP ) || urlPattern.toUpperCase().endsWith( HTTPS ) ) { // For an HTTP/HTTPS url, pass it through without modification m_jsp = urlPattern; m_jspFriendlyName = "Special Page"; } else { // For local JSPs, take everything to the left of ?, then // delete all variable substitutions String jsp = urlPattern; int qPosition = urlPattern.indexOf( '?' ); if ( qPosition != -1 ) { jsp = jsp.substring( 0, qPosition ); } m_jsp = removeSubstitutions(jsp); // Calculate the "friendly name" for the JSP if ( m_jsp.toUpperCase().endsWith( ".JSP" ) ) { m_jspFriendlyName = TextUtil.beautifyString( m_jsp.substring( 0, m_jsp.length() - 4 ) ); } else { m_jspFriendlyName = m_jsp; } } m_urlPattern = urlPattern; m_contentTemplate = contentTemplate; m_target = target; } // // This is just *so* much faster than doing String.replaceAll(). It would, in fact, // be worth to cache this value. // private String removeSubstitutions(String jsp) { //return jsp.replaceAll( "\u0025[a-z|A-Z]", "" ); StringBuffer newjsp = new StringBuffer( jsp.length() ); for( int i = 0; i < jsp.length(); i++ ) { char c = jsp.charAt(i); if( c == '%' && i < jsp.length()-1 && Character.isLetterOrDigit( jsp.charAt(i+1) ) ) { i++; continue; } newjsp.append( c ); } return newjsp.toString(); } /** * Returns a defensively-created array of all * static Commands. * @return the array of commands */ public static final Command[] allCommands() { return ALL_COMMANDS.clone(); } /** * @see com.ecyrd.jspwiki.ui.Command#targetedCommand(Object) */ public abstract Command targetedCommand( Object target ); /** * @see com.ecyrd.jspwiki.ui.Command#getContentTemplate() */ public final String getContentTemplate() { return m_contentTemplate; } /** * @see com.ecyrd.jspwiki.ui.Command#getJSP() */ public final String getJSP() { return m_jsp; } /** * @see com.ecyrd.jspwiki.ui.Command#getName() */ public abstract String getName(); /** * @see com.ecyrd.jspwiki.ui.Command#getRequestContext() */ public final String getRequestContext() { return m_requestContext; } /** * @see com.ecyrd.jspwiki.ui.Command#getTarget() */ public final Object getTarget() { return m_target; } /** * @see com.ecyrd.jspwiki.ui.Command#getURLPattern() */ public final String getURLPattern() { return m_urlPattern; } /** * Returns the "friendly name" for this command's JSP, namely * a beatified version of the JSP's name without the .jsp suffix. * @return the friendly name */ protected final String getJSPFriendlyName() { return m_jspFriendlyName; } /** * Returns a String representation of the Command. * @see java.lang.Object#toString() */ public final String toString() { return "Command" + "[context=" + m_requestContext + "," + "urlPattern=" + m_urlPattern + "," + "jsp=" + m_jsp + ( m_target == null ? "" : ",target=" + m_target + m_target.toString() ) + "]"; } }
