[其他类别]PHP开源框架 JCAT 0.3.2.1247_jcat_0.3.2.1247.rar

<?php /////////////////////////////////////////////////////////////////////////////////////////////////////// // 这个文件是 JCAT PHP框架的一部，该项目和此文件 均遵循 GNU 自由软件协议 // // Copyleft 2008 JeCat.cn(http://team.JeCat.cn) // // // JCAT PHP框架 的正式全名是：Jellicle Cat PHP Framework。 // “Jellicle Cat”出自 Andrew Lloyd Webber的音乐剧《猫》（《Prologue:Jellicle Songs for Jellicle Cats》）。 // JCAT 是一个开源项目，它像音乐剧中的猫一样自由，你可以毫无顾忌地使用JCAT PHP框架。 // JCAT 由中国团队开发维护，是一个国际性的项目。 // 正在使用的这个版本是：0.3.2 / SVN信息：$Id: class.JCAT_Package.php 1250 2009-02-07 04:53:17Z aleechou $ // // // // 相关的链接： // [主页] http://jcat.JeCat.cn // [HTTP下载] http://jcat.JeCat.cn/download // [在线文档] http://jcat.JeCat.cn/document // [社区] http://jj.jecat.cn/forum-7-1.html // 不很相关： // [MP3] http://www.google.cn/search?q=jellicle+songs+for+jellicle+cats+Andrew+Lloyd+Webber // [VCD/DVD] http://www.google.cn/search?q=CAT+Andrew+Lloyd+Webber+video // /////////////////////////////////////////////////////////////////////////////////////////////////////// /*-- Project Introduce --*/ include_once dirname(__FILE__).'/SOAP/interface.JCAT_ISSMI.php' ; /** * 包管理类,这是一个静态类 * * @author alee * @access public */ class JCAT_Package implements JCAT_ISSMI { /** * 导入整个包 * * @access public * @param $sPackage string 被导入的包的路径 或 包的ID(JCAT类中的一个常量)， * @param $bForceRefreshCache=fasle bool 强制重建 Classes Path 文件 * @static * @return void */ static public function Import( $sPackage, $bForceRefreshCache=false ) { // 检查路径 if( !is_dir($sPackage) ) { throw new JCAT_Exception("Package:'{$sPackage}' does not exists.",JCAT_Exception::MakeExceptionCode(__CLASS__,1)) ; } $sPackagePath = realpath($sPackage).'/' ; // 创建 Classes Path 文件 $sClassesPathFile = $sPackagePath.self::$sClassesPathFilename ; if( JCAT_ProjectState::Get(JCAT_ProjectState::ALWAYS_RECREATE_CLASSESPATH) or $bForceRefreshCache or !is_file($sClassesPathFile) ) { // 类路径 文件 if( !is_file($sClassesPathFile) ) { if( $hFile=fopen($sClassesPathFile,'a') ) { fclose($hFile); chmod($sClassesPathFile,0666) ; } else { return false ; } } $arrFileLines = array('<?') ; // 扫描类 $arrClassesPath = self::ScanClass($sPackagePath) ; foreach ($arrClassesPath as $arrMapping) { $arrFileLines[] = __CLASS__."::RegisterClass('{$arrMapping['class']}',\$sDirectoryBase.'{$arrMapping['file']}') ;" ; } $arrFileLines[] = '?>' ; $sFileContents = implode("\r\n",$arrFileLines) ; // 写入文件 if( !file_put_contents($sClassesPathFile,$sFileContents) ) { throw new JCAT_Exception( JCAT_Language::SentenceEx('请确保拥有权限，无法创建 Classes Path 文件：%s','JCAT',null,$sClassesPathFile) , __macro_exception_code__ ) ; } } // 读取 Classes Path 文件 $sDirectoryBase = $sPackagePath ; // <<--- 在 $sClassesPathFile 文件中用到的变亮 require_once $sClassesPathFile ; } /** * 导入一个类 * * * @access public * @param $sClass string 类名或类文件完整路径 * @param $PathOrPackageID=null string,int 类文件的路径 或 所在包的ID * @static * @return void */ static public function ImportClass( $sClass, $PathOrPackageID=null ) { // 类已经导入 if( self::ClassExists($sClass) ) { return ; } // 指定文件 if( is_file($sClass) ) { require_once ($sClass) ; return ; } // 提供类名 else { JCAT_ASSERT::ASSERT_ISTHESE($PathOrPackageID,array('string','int')); // 参数 $PathOrPackageID 为路径 if( is_string($PathOrPackageID) ) { $sClassPath =& $PathOrPackageID ; } // 参数 $PathOrPackageID 为 包ID else if( is_int($PathOrPackageID) ) { $sClassPath = self::GetPackagePath($PathOrPackageID) ; } else { JCAT_ASSERT::ASSERT_(0,'!?') ; } // 在目录中依据 JCAT 命名规则 寻找 class 文件 if(is_dir($sClassPath)) { $sClassPath = self::FindClassFileByNamingRule($sClass,$sClassPath) ; if($sClassPath===false) { JCAT_ASSERT::ASSERT_(0,"Coundn`t found class {$sClass}`s file and imported it. ",JCAT_Exception::MakeExceptionCode(__CLASS__,2)) ; } } // 载入 require $sClassPath ; } } /** * 导入一个接口 * * @access public * @param $sInterface string 类名或类文件完整路径 * @param $nPackage=null int 类所在的包 * @static * @return void */ static public function ImportInterface( $sInterface, $nPackage=null ) { // 指定文件 if( is_file($sInterface) ) { require_once ($sInterface) ; return ; } // else { // 类已经导入 if( self::ClassExists($sInterface,true) ) return ; // 包 所在目录 $sPackage = self::GetPackagePath($nPackage) ; // 按照命名规则寻找类文件 $sPath = self::FindClassFileByNamingRule($sInterface,$sPackage,self::$arrInterfaceFilePatterns) ; if($sPath===false) throw new JCAT_Exception("Coundn`t found interface {$sInterface}`s file and imported it. ",JCAT_Exception::MakeExceptionCode(__CLASS__,3)) ; // 载入 require $sPath ; } } /** * What's this Method ? * * @access public * @param $Methods='*' string,array 被导入的静态方法，可以是 数组（多个方法的名称），字串（指定的方法名称），和'*'（所有的静态方法） * @param $sClass string 类名 * @param $PackageOrClassFile int,string 类所属包的ID 或 类文件的完整路径 * @return int */ static public function ImportStaticMethod( $Methods='*', $sClass, $PackageOrClassFile ) { // $PackageOrClassFile 包ID if( is_int($PackageOrClassFile) ) { $sPackagePath = self::GetPackagePath($PackageOrClassFile) ; if( empty($sPackagePath) ) throw new JCAT_Exception("无效的 包ID：$nPackage ",JCAT_Exception::MakeExceptionCode(__CLASS__,4)) ; // 找到类文件 $sClassPath = self::FindClassFileByNamingRule($sClass,$sPackagePath) ; if( $sClassPath===false ) throw new JCAT_Exception("无法根据 JCAT的文件命名规则找到类:{$sClass} 的文件 ",JCAT_Exception::MakeExceptionCode(__CLASS__,5)) ; } // $PackageOrClassFile 类文件的完整路径 else if( is_string($PackageOrClassFile) ) { if( !is_file($PackageOrClassFile) ) throw new JCAT_Exception("参数\$PackageOrClassFile 必须为 有效的包ID(int) 或 一个存在的类文件(string)。",JCAT_Exception::MakeExceptionCode(__CLASS__,8)) ; $sClassPath = $PackageOrClassFile ; } // $PackageOrClassFile 参数无效 else throw new JCAT_Exception("参数\$PackageOrClassFile 必须为 有效的包ID(int) 或 一个存在的类文件(string)",JCAT_Exception::MakeExceptionCode(__CLASS__,9)) ; // 获取 所有的静态方法 if( $Methods==='*' ) { $Methods = array() ; $arrAllMethods = get_class_methods($sClass) ; foreach($arrAllMethods as $sMethod) { $aRef = new ReflectionMethod($sClass,$sMethod) ; if( !$aRef->isStatic() ) continue ; $Methods[] = $sMethod ; } } // 检查参数类型 if( !is_array($Methods) ) throw new JCAT_Exception("参数 $Methods 非法。",JCAT_Exception::MakeExceptionCode(__CLASS__,6)) ; // 创建 与方法 同名的全局函数 $nCount = 0 ; foreach($Methods as $sMethod) { JCAT_Global::MakeFunctionAlias($sMethod,array($sClass,$sMethod)) ; $nCount ++ ; } return $nCount ; } /** * 从一个 实例文件