quercuspage.java

RESIN 3.2 最新源码

/*
 * Copyright (c) 1998-2008 Caucho Technology -- all rights reserved
 *
 * This file is part of Resin(R) Open Source
 *
 * Each copy or derived work must preserve the copyright notice and this
 * notice unmodified.
 *
 * Resin Open Source is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * Resin Open Source is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
 * of NON-INFRINGEMENT.  See the GNU General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License
 * along with Resin Open Source; if not, write to the
 *
 *   Free Software Foundation, Inc.
 *   59 Temple Place, Suite 330
 *   Boston, MA 02111-1307  USA
 *
 * @author Scott Ferguson
 */

package com.caucho.quercus.page;

import com.caucho.quercus.Location;
import com.caucho.quercus.Quercus;
import com.caucho.quercus.env.Env;
import com.caucho.quercus.env.NullValue;
import com.caucho.quercus.env.QuercusLanguageException;
import com.caucho.quercus.env.Value;
import com.caucho.quercus.program.AbstractFunction;
import com.caucho.quercus.program.ClassDef;
import com.caucho.util.L10N;
import com.caucho.vfs.Path;

import java.util.HashMap;
import java.util.Map;

/**
 * Represents a compiled PHP program.
 */
abstract public class QuercusPage
{
  private static final L10N L = new L10N(QuercusPage.class);
  
  private HashMap<String,AbstractFunction> _funMap
    = new HashMap<String,AbstractFunction>();
  
  private HashMap<String,AbstractFunction> _funMapLowerCase
    = new HashMap<String,AbstractFunction>();
  
  private HashMap<String,ClassDef> _classMap
    = new HashMap<String,ClassDef>();

  /**
   * Returns true if the page is modified.
   */
  public boolean isModified(Env env)
  {
    return false;
  }

  /**
   * Returns the page's path.
   */
  abstract public Path getSelfPath(Env env);
  
  /**
   * Finds a function.
   */
  public AbstractFunction findFunction(String name)
  {
    AbstractFunction fun = _funMap.get(name);

    if (fun != null)
      return fun;

    fun = _funMapLowerCase.get(name.toLowerCase());

    return fun;
  }

  /**
   * Finds a function.
   */
  public ClassDef findClass(String name)
  {
    return _classMap.get(name);
  }

  /**
   * Returns the class map.
   */
  public HashMap<String,ClassDef> getClassMap()
  {
    return _classMap;
  }

  /**
   * Execute the program as top-level, i.e. not included.
   *
   * @param env the calling environment
   */
  public Value executeTop(Env env)
  {
    Path oldPwd = env.getPwd();

    Path pwd = getPwd(env);

    env.setPwd(pwd);
    try {
      return execute(env);
    } catch (QuercusLanguageException e) {
      if (env.getExceptionHandler() != null) {
        try {
          env.getExceptionHandler().call(env, e.getValue());
        }
        catch (QuercusLanguageException e2) {
          uncaughtExceptionError(env, e2);
        }
      }
      else {
        uncaughtExceptionError(env, e);
      }
      
      return NullValue.NULL;
    } finally {
      env.setPwd(oldPwd);
    }
  }

  /*
   * Throws an error for this uncaught exception.
   */
  private void uncaughtExceptionError(Env env, QuercusLanguageException e)
  {
    Location location = e.getLocation(env);
    String type = e.getValue().getClassName();
    String message = e.getMessage(env);
    
    env.error(location,
              L.l("Uncaught exception of type '{0}' with message '{1}'", type, message));
  }
  
  /**
   * Returns the pwd according to the source page.
   */
  public Path getPwd(Env env)
  {
    return getSelfPath(env).getParent();
  }


  /**
   * Execute the program
   *
   * @param env the calling environment
   */
  abstract public Value execute(Env env);

  /**
   * Initialize the program
   *
   * @param quercus the owning engine
   */
  public void init(Quercus quercus)
  {
  }

  /**
   * Initialize the environment
   *
   * @param quercus the owning engine
   */
  public void init(Env env)
  {
  }

  /**
   * Imports the page definitions.
   */
  public void importDefinitions(Env env)
  {
    for (Map.Entry<String,AbstractFunction> entry : _funMap.entrySet()) {
      AbstractFunction fun = entry.getValue();

      if (fun.isGlobal())
	env.addFunction(entry.getKey(), entry.getValue());
    }
    
    for (Map.Entry<String,ClassDef> entry : _classMap.entrySet()) {
      env.addClassDef(entry.getKey(), entry.getValue());
    }
  }

  /**
   * Adds a function.
   */
  protected void addFunction(String name, AbstractFunction fun)
  {
    _funMap.put(name, fun);
    _funMapLowerCase.put(name.toLowerCase(), fun);
  }

  /**
   * Adds a class.
   */
  protected void addClass(String name, ClassDef cl)
  {
    _classMap.put(name, cl);
  }
  
  public String toString()
  {
    return getClass().getSimpleName() + "[]";
  }
}