org.directwebremoting.extend.DebugPageGenerator Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of dwr Show documentation

DWR is easy Ajax for Java. It makes it simple to call Java code directly from Javascript. It gets rid of almost all the boiler plate code between the web browser and your Java code.

The newest version!

/*
 * Copyright 2005 Joe Walker
 *
 * Licensed 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.directwebremoting.extend;

import java.util.Collection;

/**
 * The heart of DWR is a system to generate content from some requests.
 * This interface generates scripts and executes remote calls.
 * @author Joe Walker [joe at getahead dot ltd dot uk]
 */
public interface DebugPageGenerator
{
    /**
     * Generate some HTML that represents an index page
     * @param root The prefix common to all DWR URLs. Usually contextPath+servletPath
     * @return An index page in HTML
     * @throws SecurityException If the pages are not accessible
     */
    String generateIndexPage(String root) throws SecurityException;

    /**
     * Generate some HTML that represents a test page for a given script
     * @param root The prefix common to all DWR URLs. Usually contextPath+servletPath
     * @param scriptName The script to generate for
     * @return A test page in HTML
     * @throws SecurityException If the pages are not accessible
     */
    String generateTestPage(String root, String scriptName) throws SecurityException;

    /**
     * For a given remoted class, generate a URL that will retrieve the
     * Javascript interface
     * @param root The prefix common to all DWR URLs. Usually contextPath+servletPath
     * @param scriptName The script to generate for
     * @return A URL that points at the given scriptName
     * @deprecated Please tell the DWR users mailing list [email protected] if you use this
     */
    @Deprecated
    String generateInterfaceUrl(String root, String scriptName);

    /**
     * Create a url that links to the engine.js file
     * @param root The prefix common to all DWR URLs. Usually contextPath+servletPath
     * @return A URL that points at the central engine Javascript file
     * @deprecated Please tell the DWR users mailing list [email protected] if you use this
     */
    @Deprecated
    String generateEngineUrl(String root);

    /**
     * Create a url that links to one of the library files
     * @param root The prefix common to all DWR URLs. Usually contextPath+servletPath
     * @param library The name of a library as returned by {@link DebugPageGenerator#getAvailableLibraries()}
     * @return A URL that points at the given library
     * @deprecated Please tell the DWR users mailing list [email protected] if you use this
     */
    @Deprecated
    String generateLibraryUrl(String root, String library);

    /**
     * @return A list of the available libraries.
     * @deprecated Please tell the DWR users mailing list [email protected] if you use this
     */
    @Deprecated
    Collection getAvailableLibraries();
}