pathutils.java

Jamon是一个Java文本模板引擎

/*
 * The contents of this file are subject to the Mozilla Public
 * License Version 1.1 (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.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS
 * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
 * implied. See the License for the specific language governing
 * rights and limitations under the License.
 *
 * The Original Code is Jamon code, released February, 2003.
 *
 * The Initial Developer of the Original Code is Jay Sachs.  Portions
 * created by Jay Sachs are Copyright (C) 2003 Jay Sachs.  All Rights
 * Reserved.
 *
 * Contributor(s):
 */

package org.jamon.codegen;

import org.jamon.util.StringUtils;

/**
 * Provides methods to translate template paths to the corresponding
 * interface class name, implementation class name, and the package
 * name for each.
 **/

public class PathUtils
{
    private PathUtils() {}

    /**
     * Given a template path, return the name of the interface class
     * for that template.
     *
     * @param p_path the template path
     *
     * @return the name of the interface class
     **/

    public static String getIntfClassName(final String p_path)
    {
        int i = p_path.lastIndexOf('/');
        return i < 0 ? p_path : p_path.substring(i+1);
    }

    /**
     * Given a template path, return the name of the implementation
     * class for that template.
     *
     * @param p_path the template path
     *
     * @return the name of the implementation class
     **/

    public static String getImplClassName(final String p_path)
    {
        return getIntfClassName(p_path) + "Impl";
    }


    /**
     * Given a template path, return the name of the package in which
     * the interface class for that template lives.
     *
     * @param p_path the template path
     *
     * @return the name of the interface class package
     **/

    public static String getIntfPackageName(final String p_path)
    {
        int i = p_path.lastIndexOf('/');
        if (i > 0)
        {
            return StringUtils.templatePathToClassName
                (p_path.substring(0,i));
        }
        else
        {
            return "";
        }
    }


    /**
     * Given a template path, return the name of the package in which
     * the implementation class for that template lives.
     *
     * @param p_path the template path
     *
     * @return the name of the implementation class package
     **/

    public static String getImplPackageName(final String p_path)
    {
        return getIntfPackageName(p_path);
    }

    /**
     * Given a template path, return the fully qualified name of the
     * interface class for that template.
     *
     * @param p_path the template path
     *
     * @return the fully qualified name of the interface class
     **/

    public static String getFullyQualifiedIntfClassName(final String p_path)
    {
        return fullyQualify(getIntfPackageName(p_path),
                            getIntfClassName(p_path));
    }

    /**
     * Given a template path, return the fully qualified name of the
     * implementation class for that template.
     *
     * @param p_path the template path
     *
     * @return the fully qualified name of the implementation class
     **/

    public static String getFullyQualifiedImplClassName(final String p_path)
    {
        return fullyQualify(getImplPackageName(p_path),
                            getImplClassName(p_path));
    }

    /**
     * Fully qualify a class name given a package name and class name.
     *
     * @param p_pkgName the name of the package
     * @param p_className the name of the class
     *
     * @return the fully qualified name of the class
     **/

    private static String fullyQualify(final String p_pkgName,
                                       final String p_className)
    {
        return "".equals(p_pkgName)
            ? p_className
            : (p_pkgName + "." + p_className);
    }
}