Please wait. This can take some minutes ...
Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $
You can buy this project and download/modify it how often you want.
blanco.cg.transformer.php.BlancoCgImportPhpSourceExpander Maven / Gradle / Ivy
/*
* blanco Framework
* Copyright (C) 2004-2017 IGA Tosiki
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*/
/*
* Copyright 2017 Toshiki Iga
*
* 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 blanco.cg.transformer.php;
import java.util.Collections;
import java.util.Comparator;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import blanco.cg.BlancoCgSupportedLang;
import blanco.cg.util.BlancoCgLineUtil;
import blanco.cg.valueobject.BlancoCgSourceFile;
import blanco.commons.util.BlancoNameUtil;
import blanco.commons.util.BlancoStringUtil;
/**
* BlancoCgSourceFileのなかの import情報を展開します。
*
* このクラスはblancoCgのバリューオブジェクトからソースコードを自動生成するトランスフォーマーの個別の展開機能です。
* import展開は意外にも複雑な処理です。
*
* @author IGA Tosiki
*/
class BlancoCgImportPhpSourceExpander {
/**
* このクラスが処理対象とするプログラミング言語。
*/
protected static final int TARGET_LANG = BlancoCgSupportedLang.PHP;
/**
* ソート時に優先して処理されるパッケージ一覧。
*/
private static final String[] PREFERRED_PACKAGE = { "java.", "javax.",
"org.", "blanco.", "com." };
/**
* 一般的に知られているPHPモジュール。
*/
private static final String[] PHP_MODULE = { "apache", "bcmath", "bz2",
"calendar", "com2", "cpdf", "ctype", "curl", "dba", "dbase", "dbx",
"dio", "dom", "exif", "fam", "fbsql", "fdf", "filepro", "ftp",
"gd", "gettext", "gmp", "hwapi", "iconv", "imap", "informix",
"ingres", "interbase", "ircg", "ldap", "libxml", "mbstring",
"mcrypt", "mcve", "mhash", "mime_magic", "ming", "mnogosearch",
"msession", "msql", "mssql", "mysql", "mysqli", "ncurses", "nsapi",
"oci", "odbc", "openssl", "oracle", "ovrimossql", "pcntl", "pcre",
"pdo", "pfpro", "pgsql", "posix", "pspell", "readline", "recode",
"regex", "session", "shmop", "snmp", "soap", "sockets", "spl",
"sqlite", "standard", "standard_reflection", "streams", "sybase",
"sysvmsg", "sysvsem", "sysvshm", "tidy", "tokenizer", "variant",
"wddx", "xml", "xmlrpc", "yp", "zlib" };
/**
* import文を展開するためのアンカー文字列。
*/
private static final String REPLACE_IMPORT_HERE = "/*replace import here*/";
/**
* 発見されたアンカー文字列のインデックス。
*
* このクラスの処理の過程で import文が編集されますが、その都度 この値も更新されます。
*/
private int fFindReplaceImport = -1;
/**
* importを展開します。
*
* このメソッドはクラス展開・メソッド展開など一式が終了した後に呼び出すようにします。
*
* @param argSourceFile
* ソースファイルインスタンス。
* @param argSourceLines
* ソース行イメージ。(java.lang.Stringが格納されます)
*/
public void transformImport(final BlancoCgSourceFile argSourceFile,
final List argSourceLines) {
// import対象のクラス名終端に付与されている配列表現を除去します。
trimArraySuffix(argSourceFile.getImportList());
// 最初にimport文をソートして処理を行いやすくします。
sortImport(argSourceFile.getImportList());
// 重複するimport文を除去します。
trimRepeatedImport(argSourceFile.getImportList());
// importする必要のないクラスを除去します
trimUnnecessaryImport(argSourceFile.getImportList());
// 自クラスが所属するパッケージに対するimportを抑制します。
// PHPには自クラスが所属するパッケージという概念がありません。
// trimMyselfImport(argSourceFile, argSourceFile.getImportList());
// アンカー文字列を検索します。
fFindReplaceImport = findAnchorString(argSourceLines);
if (fFindReplaceImport < 0) {
throw new IllegalArgumentException("import文の置換文字列を発見することができませんでした。");
}
for (int indexPreferredPackage = 0; indexPreferredPackage < PREFERRED_PACKAGE.length; indexPreferredPackage++) {
// 優先パッケージを最初に展開します。
expandImportWithTarget(argSourceFile,
PREFERRED_PACKAGE[indexPreferredPackage], argSourceLines);
}
// 最後に優先パッケージ以外 (「java.」「javax.」など以外)のパッケージを展開します。
expandImportWithTarget(argSourceFile, null, argSourceLines);
// アンカー文字列を除去します。
removeAnchorString(argSourceLines);
}
/**
* import(using)のリストからクラス名を除去します。
*
* これは、C#.NETでは名前空間単位のusing指定を行うからです。
* まずクラス名を除去して皇族の処理を実行します。
*
* @param strImport
* ソースファイルオブジェクト。
*/
private String trimClassName(final String strImport) {
final int findLastDot = strImport.lastIndexOf('.');
if (findLastDot > 0) {
return strImport.substring(0, findLastDot);
}
return strImport;
}
/**
* 展開対象となるターゲットを意識してインポートを展開します。
*
* @param argSourceFile
* @param argTarget
* java. または javax. または nullを指定します。
* @param argSourceLines
* ソースコード行リスト。
*/
private void expandImportWithTarget(final BlancoCgSourceFile argSourceFile,
final String argTarget, final List argSourceLines) {
boolean isProcessed = false;
final Map mapModule = new HashMap();
for (int index = 0; index < argSourceFile.getImportList().size(); index++) {
final String strImport = argSourceFile.getImportList().get(index);
if (argTarget == null) {
// 優先パッケージ以外 (java. javax. 以外) を展開します。
if (isPreferredPackage(strImport)) {
// 処理対象とするパッケージ以外であるので、処理をスキップします。
// ※java. および javax. はハードコードされている点に注意してください。
continue;
}
} else {
if (strImport.startsWith(argTarget) == false) {
// 処理対象とするパッケージ以外であるので、処理をスキップします。
continue;
}
}
isProcessed = true;
final String packageName = trimClassName(strImport);
boolean isModule = false;
for (int indexModule = 0; indexModule < PHP_MODULE.length; indexModule++) {
if (packageName.equals(PHP_MODULE[indexModule])) {
isModule = true;
break;
}
}
if (isModule) {
if (mapModule.get(trimClassName(strImport)) != null) {
// 処理済モジュール名の場合には展開しません。
} else {
argSourceLines.add(fFindReplaceImport++,
"/*. require_module '"
+ trimClassName(strImport)
+ "'; .*/"
+ BlancoCgLineUtil
.getTerminator(TARGET_LANG));
}
// 処理済モジュール名として記憶します。
mapModule.put(trimClassName(strImport), strImport);
} else {
// パッケージ名をディレクトリ名として展開します。
argSourceLines.add(fFindReplaceImport++, "require_once('"
+ BlancoStringUtil.replaceAll(strImport, ".", "/")
+ ".php')"
+ BlancoCgLineUtil.getTerminator(TARGET_LANG));
}
}
if (isProcessed) {
// import展開処理が存在した場合にのみ空白を付与します。
argSourceLines.add(fFindReplaceImport++, "");
}
}
/**
* 置換アンカー文字列の行数(0オリジン)を検索します。
*
* @return 発見したアンカー文字列の位置(0オリジン)。発見できなかった場合には-1。
* @param argSourceLines
* ソースリスト。
*/
private static final int findAnchorString(
final List argSourceLines) {
for (int index = 0; index < argSourceLines.size(); index++) {
final String line = argSourceLines.get(index);
if (line.equals(REPLACE_IMPORT_HERE)) {
// 発見しました。
return index;
}
}
// 発見できませんでした。発見できなかったことを示す -1 を戻します。
return -1;
}
/**
* アンカー文字列を挿入します。
*
* 処理の後半でインポート文を編成しなおしますが、その際に参照するアンカー文字列を追加しておきます。
* このメソッドは他のクラスから呼び出されます。
*
* @param argSourceLines
* ソースリスト。
*/
public static final void insertAnchorString(
final List argSourceLines) {
argSourceLines.add(BlancoCgImportPhpSourceExpander.REPLACE_IMPORT_HERE);
}
/**
* アンカー文字列を除去します。
*
* @param argSourceLines
* ソースリスト。
*/
private static final void removeAnchorString(
final List argSourceLines) {
// 最後にアンカー文字列そのものを除去。
int findReplaceImport2 = findAnchorString(argSourceLines);
if (findReplaceImport2 < 0) {
throw new IllegalArgumentException("import文の置換文字列を発見することができませんでした。");
}
argSourceLines.remove(findReplaceImport2);
}
/**
* 与えられたimportをソートします。
*
* 想定されるノードの型(java.lang.String)以外が与えられると、例外が発生します。
*
* @param argImport
* インポートリスト。
*/
private static final void sortImport(final List argImport) {
Collections.sort(argImport, new Comparator() {
public int compare(final String arg0, final String arg1) {
if (arg0 instanceof String == false) {
throw new IllegalArgumentException("importのリストの値ですが、["
+ arg0 + "]ですが java.lang.String以外の型["
+ arg0.getClass().getName() + "]になっています。");
}
if (arg1 instanceof String == false) {
throw new IllegalArgumentException("importのリストの値ですが、["
+ arg1 + "]ですが java.lang.String以外の型["
+ arg1.getClass().getName() + "]になっています。");
}
final String str0 = (String) arg0;
final String str1 = (String) arg1;
return str0.compareTo(str1);
}
});
}
/**
* import対象のクラス名終端に付与されている配列表現を除去します。
*
* @param argImport
* インポートリスト。
*/
private void trimArraySuffix(final List argImport) {
for (int index = 0; index < argImport.size(); index++) {
String strImport = argImport.get(index);
for (;;) {
// 配列表現で終了している限り繰り返します。
if (strImport.indexOf("[") > 0) {
// カギカッコではじまっているところ以降は必要ありません。
strImport = strImport.substring(0, strImport.indexOf("["));
argImport.set(index, strImport);
} else {
break;
}
}
}
}
/**
* 重複する不要なimportを除去します。
*
* このメソッドは、与えられたListが既にソート済みであることを前提とします。
*
* @param argImport
* インポートリスト。
*/
private void trimRepeatedImport(final List argImport) {
// 重複するimportを除去。
String pastImport = "";
for (int index = argImport.size() - 1; index >= 0; index--) {
final String strImport = argImport.get(index);
if (pastImport.equals(strImport)) {
// 既に処理されている重複するimportです。不要なのでこれを除去します。
argImport.remove(index);
}
// 今回のimportを前回分importとして記憶します。
pastImport = strImport;
}
}
/**
* importする必要のないクラスを除去します。
*
* 具体的には java.lang や プリミティブ型が不要と判断される対象です。
*
* @param argImport
* インポートリスト。
*/
private void trimUnnecessaryImport(final List argImport) {
// まずはプリミティブ型を除去します。
for (int index = argImport.size() - 1; index >= 0; index--) {
final String strImport = argImport.get(index);
if (BlancoCgTypePhpSourceExpander
.isLanguageReservedKeyword(strImport)) {
argImport.remove(index);
}
}
// 次に java.langを除去します。
// これは Java言語において java.langパッケージは暗黙のうちにインポートされるパッケージであるからです。
trimSpecificPackage("java.lang", argImport);
}
/**
* 与えられた文字列が優先パッケージであるかどうかをチェックします。
*
* @param argCheck
* チェックしたい文字列。
* @return 優先パッケージに該当したかどうか。
*/
private boolean isPreferredPackage(final String argCheck) {
for (int index = 0; index < PREFERRED_PACKAGE.length; index++) {
if (argCheck.startsWith(PREFERRED_PACKAGE[index])) {
// この文字列は優先パッケージに該当します。
return true;
}
}
// キーワードにヒットしませんでした。この文字列はプログラミング言語の予約語ではありません。
return false;
}
/**
* 自分自身が所属するパッケージのimportを除去します。
*
* @param argSourceFile
* ソースファイルインスタンス。
* @param argImport
* インポートリスト。
*/
// private void trimMyselfImport(final BlancoCgSourceFile argSourceFile,
// final List argImport) {
// trimSpecificPackage(argSourceFile.getPackage(), argImport);
// }
/**
* 特定のパッケージについて、これをリストから除去します。
*
* java.langの除去および自クラスが所属するパッケージの除去に利用されます。
*
* @param argSpecificPackage
* 処理対象とするパッケージ。
* @param argImport
* インポートのリスト。
*/
private static void trimSpecificPackage(final String argSpecificPackage,
final List argImport) {
for (int index = argImport.size() - 1; index >= 0; index--) {
final String strImport = argImport.get(index);
if (strImport.indexOf(".") < 0) {
// パッケージ構造を持たないため、削除候補からはずします。
continue;
}
// import処理においては、blancoCgのTypeに関する共通処理を利用することはできません。
// 個別に記述を行います。
final String strImportWithoutPackage = BlancoNameUtil
.trimJavaPackage(strImport);
final String strPackage = strImport.substring(0, strImport.length()
- strImportWithoutPackage.length());
if ((argSpecificPackage + ".").equals(strPackage)) {
// java.lang.Stringなどは除去します。
argImport.remove(index);
}
}
}
}