Field Detail

• public static grails.core.DefaultGrailsApplication application

  grailsApplication

• public static org.springframework.web.context.support.GenericWebApplicationContext context

  grailsApplication.getMainContext()

Method Detail

• static List<String> errorMessages(Object bean)

  从bean里获得错误信息，并返回错误信息（字符串）列表

• static org.grails.buffer.StreamCharBuffer evalGspFrag(String gspText, Map model)

  执行 gsp 代码片段

  Returns:

  执行结果的字符串

  Parameters:

  gspText

• static Object evalScript(String script, Binding binding, Map params)

  执行脚本：使用GSE，避免每次都编译

  Returns:

  Parameters:

  script - 脚本内容

  binding - 参数绑定，可为空

  params - 其他参数，可为空

• static List<Map> findViews(String viewPath, String prefix)

  在应用和各个插件下搜索视图模板

  视图模板位于 viewPath 下，名称为 _prefix_插件名.gsp，如果在应用下，则后缀插件名为app。

  Returns:

  按照依赖关系排序（依赖多的靠后）后、形如 [template: 视图完整路径, plugin: 插件名或null] 的 Map 列表

  Parameters:

  viewPath - 视图路径，如 "/bropen/framework/core/security/User/"

  prefix - 视图模板名前缀，如 foobar

• @Internal@bropen.toolkit.annotation.Internal static String fixPluginName(String name)

• static List<String> getAllPluginNames()

  获得所有按照依赖关系排列（依赖多的靠后）后的插件名称列表

• static List<grails.plugins.GrailsPlugin> getAllPlugins()

  获得所有按照依赖关系排列（依赖多的靠后）后的插件列表

• static String getAppName()

  获得当前应用的名称，如 Foobar

• static List<String> getAutoImportClasses()

  根据各插件的 grails-app/conf/autoimports.groovy，获得将要在GSP、Script中自动导入的类列表

• @Deprecated static Object getConfig(String path)

  获取 Config 值。主要供 java 的类使用（调用 ConfigObject 不方便）

  deprecated:

  改用 grails.util.Holders.config.getProperty 代替

  Returns:

  如果配置不存在，则返回null，否则返回值

  Parameters:

  name - 配置名，如“grails.plugin.springsecurity.ldap.active”

• static grails.plugins.GrailsPlugin getPlugin(Class clazz)

  根据 Artefact 类（如 Domain 类）计算插件

  根据编译时 Grails 自动生成的 GrailsPlugin 注解计算，如果不存在注解则返回 null。

  Returns:

  插件对象或 null（不存在或可能是应用中的类）

• static grails.plugins.GrailsPluginManager getPluginManager()

  获得插件管理器

• static String getPluginName(Class clazz)

  根据 Artefact 类（如 Domain 类）计算插件名称

  根据编译时 Grails 自动生成的 GrailsPlugin 注解计算，如果不存在注解则返回 null。

  Returns:

  插件名称或null，如 broBpm

• static String getServerURL()

  获得当前应用服务器的绝对地址

  Returns:

  以 “/” 结尾的 url 地址，如：http://xxx/cc/

• static java.io.File getSourceFile(Class domainClazz)

  开发模式下，获得类文件的源码

  如：GrailsUtils.getSourceFile(Employee)

  Returns:

  如果搜到了，则返回对应的文件对象

  Parameters:

  domainClazz - Domain 类

• static boolean isDevelopmentMode()

  是否是开发环境

  不同于 Environment 的同名方法，如果是 CUSTUM + run-app，这里也会返回 true。

• static boolean isInteractiveMode()

  是否是交互模式的 run-app

  Returns:

  如果是交互模式返回true，否则返回false

• static String isMessageLangSupported(String lang)

  判断国际化语言是否支持

  Returns:

  映射后的语言，如 zh_TW，如果不支持，则返回 null

  Parameters:

  lang - 映射前的语言，如 zh_TW

• static boolean isPluginAvailable(String pluginName)

  是否启用了某个插件

  Returns:

  如果启用该插件返回true，否则返回false

  Parameters:

  pluginName - 插件名称

• static Boolean isViewExists(String viewPath)

  在应用和各个插件下搜索视图文件是否存在

  Parameters:

  viewPath - 视图路径，如 /portal/index

• static void mergeMessages(Locale locale, Map<String, String> properties)

  合并国际化消息

  Parameters:

  locale - 如 Locale.CHINA、Locale.US 等

  properties - 要合并的消息

• static void mergeMessages(Locale locale, String key, String value)

  合并国际化消息

• @CompileDynamic@groovy.transform.CompileDynamic static String message(String code, List args = null, String defaultMsg = null, Boolean isDefaultLang = false)

  根据消息代码等，获得国际化的消息字符串（可以在Service里使用）。

  参考：http://blog.zmok.net/articles/2008/08/07/grails-internationalization-in-the-service

  Returns:

  国际化的消息字符串

  Parameters:

  code - The code to resolve the message for

  args - A list of argument values to apply to the message, when code is used.

  defaultMsg - The default message to output if the error or code cannot be found in messages.properties.

  isDefaultLang - 如为true，则取系统支持的第一种语言的消息，如果为false（默认）则取浏览器语言的消息

• static String messageLang(String lang = "default")

  计算当前使用的国际化语言

  Config 中可以配置：

  • bropen.toolkit.i18n.supported: 系统支持的i18n语言列表，如 ["zh_CN"]；
    如果客户端语言不在列表中，则取 message api 的 default 参数、或列表中的第一个语言定义。
  • bropen.toolkit.i18n.mapping: 语言不在上面列表中时的映射关系；
    如 ["zh_CN": ["zh*"]] 表示所有 zh 为前缀的语种都映射到 zh_CN，而其他语言则采用默认语言。

  Returns:

  映射后的语言，如 zh_TW

  Parameters:

  lang - 映射前的语言，如 zh_TW； 或通过 response.getLocale ( ) .getLanguage ( ) + "_" + response.getLocale().getCountry() 计算出来的结果； 如果为 default（默认值），则为当前浏览器的语言； 如果为 null，则为系统支持的第一种语言。

• static Locale messageLocale(String lang = "default")

  计算当前使用的国际化语言

• static Properties parseProperties(java.io.File configFile)

  // * 根据键值对，创建一个 Config 对象 //

• static List<Map> sortPlugins(List<Map> plugins, String order = "asc")

  按照插件的依赖关系排序。

  Returns:

  排序后的 Map 列表。如果插件名为 app 或者不存在对应名称的插件，则表示为应用，会自动排在最后（asc）或最前

  Parameters:

  plugins - 插件 Map 列表，格式为 [pluginName|name: Xyz, xxx: yyy], 其中必须要有的是 pluginName|name，其他键值对可选

  order - 排列顺序，asc（默认，依赖多的排后面） 或 desc