English
资源说明：
#
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# - Kerneos
# - Copyright (C) 2008-2009 Bull S.A.S.
# - Contact: jasmine@ow2.org
# -
# - 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 any later version.
# -
# - This library 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. See the GNU
# - Lesser General Public License for more details.
# -
# - You should have received a copy of the GNU Lesser General Public
# - License along with this library; if not, write to the Free Software
# - Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
# - USA
# -
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# - $Id$
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#
// ////////////////////////////////////////////////////////////////////////////
// Compile Kerneos with maven :
// ////////////////////////////////////////////////////////////////////////////
Some flex libraries need to be added manually from a flex sdk. The following
commands are for a 3.0.0.477 sdk version:
The jar for the flex license (to use a license, specify the FLEX_LICENSE
environment variable) :
mvn install:install-file -DgroupId=com.adobe.flex -DartifactId=license -Dversion=3.0.0.477 -Dpackaging=jar -Dfile=${flexSDK_path}/lib/license.jar
The datavisualization flex libraries :
mvn install:install-file -DgroupId=com.adobe.flex.sdk -DartifactId=datavisualization -Dversion=3.0.0.477 -Dpackaging=swc -Dfile=${flexSDK_path}/frameworks/libs/datavisualization.swc
mvn install:install-file -DgroupId=com.adobe.flex.sdk -DartifactId=datavisualization -Dversion=3.0.0.477 -Dpackaging=rb.swc -Dfile=${flexSDK_path}/frameworks/locale/en_US/datavisualization_rb.swc
mvn install:install-file -DgroupId=com.adobe.flex.sdk -DartifactId=datavisualization -Dversion=3.0.0.477 -Dclassifier=en_US -Dpackaging=rb.swc -Dfile=${flexSDK_path}/frameworks/locale/en_US/datavisualization_rb.swc
mvn install:install-file -DgroupId=com.adobe.flex.sdk -DartifactId=datavisualization -Dversion=3.0.0.477 -Dclassifier=fr_FR -Dpackaging=rb.swc -Dfile=${flexSDK_path}/frameworks/locale/en_US/datavisualization_rb.swc
// ////////////////////////////////////////////////////////////////////////////
// How to use the archetypes
// ////////////////////////////////////////////////////////////////////////////
Some very new archetype that allows users to quickly set up a maven project
to develop a flex based web application using Kerneos is now available.
Some tips on how to use them :
- the first step could be to prepare a folder that contains a main
pom.xml file. this file will be the parent file of the entire
project.
- Going into this folder, create one maven module that will trigger the
war file, and other maven modules to trigger flex modules. to do,
just follow those steps :
- create the war structure by executing the following command line
mvn archetype:generate \
-DarchetypeGroupId=org.ow2.kerneos \
-DarchetypeArtifactId=kerneos-war-archetype \
-DarchetypeVersion=1.3.1-SNAPSHOT \
-DgroupId=your.group.id \
-DartifactId=your-war-artifact-name \
-Dversion=version-of-your-war
- create a kerneos module structure with a similar command line
mvn archetype:generate \
-DarchetypeGroupId=org.ow2.kerneos \
-DarchetypeArtifactId=kerneos-module-archetype \
-DarchetypeVersion=1.3.1-SNAPSHOT \
-DgroupId=your.group.id \
-DartifactId=your-module-artifact-name \
-Dversion=version-of-your-module
- You should then have a structure that looks this way
main folder
|-- pom.xml
|-- your-war-artifact-name
| |-- pom.xml
| `-- src
| `-- main
| `-- webapp
| |-- AC_OETags.js
| |-- META-INF
| | `-- kerneos-config.xml
| |-- WEB-INF
| | |-- classes
| | | `-- log4j.xml
| | |-- flex
| | | `-- services-config.xml
| | |-- granite
| | | `-- granite-config.xml
| | `-- web.xml
| |-- history
| | |-- history.css
| | |-- history.js
| | `-- historyFrame.html
| |-- index.html
| `-- resources
| `-- kerneos-config.xsd
|
`-- your-module-artifact-name
|-- client
| |-- pom.xml
| `-- src
| `-- main
| |-- flex
| | |-- MyModule.mxml
| | |-- business
| | | |-- IModuleDelegate.as
| | | `-- ModuleDelegate.as
| | |-- command
| | | `-- ModuleCommand.as
| | |-- control
| | | `-- Controller.as
| | |-- event
| | | `-- ModuleEvent.as
| | |-- model
| | | `-- ModuleModelLocator.as
| | `-- view
| | `-- MainView.mxml
| |-- locales
| | |-- en_US
| | | `-- moduleResources.properties
| | `-- fr_FR
| | |-- CairngormMessages.properties
| | `-- moduleResources.properties
| `-- resources
| `-- flex
| `-- services-config.xml
|-- server
| |-- pom.xml
| `-- src
| |-- main
| | `-- java
| | `-- Service.java
| `-- test
| `-- java
| `-- ServiceTest.java
`-- pom.xml
Nota :
If the war module is built as soon as the structure is created, it can
be deployed directly on a tomcat webserver without any other work.
- Link the main pom.xml file with the two new module created.
- Finally, configure the war to
- embed the new flex module, created (the swf file).
- include the module on the Kerneos desktop by setting up the
Kerneos configuration file.
// ////////////////////////////////////////////////////////////////////////////
// Before investigations ...
// ////////////////////////////////////////////////////////////////////////////
Before using Kerneos :
ex (for JOnAS 5.x) :
This is the entry if you want to use the log in composant.
eos {
// Use LoginModule for EoS authentication
org.ow2.jonas.security.auth.spi.JResourceLoginModule required
resourceName="memrlm_1"
;
};
However, Kerneos is actually based on the JavaEE authentication. Just set
it in the web.xml file. The default configuration uses the tomcat role name,
and the BASIC type.
// ////////////////////////////////////////////////////////////////////////////
// How to use WTP to develop Kerneos :
// ////////////////////////////////////////////////////////////////////////////
- First run the following command : mvn -P initWTP to copy some dependencies
in the WTP webapp lib directory
- set a JOnAS 5 server in your Eclipse environment
- load the main page : http://localhost:9000/kerneos/Kerneos.html
////////////////////////////////////////////////////////////////////////////
// How to add a new module to core
////////////////////////////////////////////////////////////////////////////
Note :
------
All the modules added on a same core should have been compiled with the same
context root, the same as were the application is deployed.
Add modules :
-------------
Kerneos simply relies on a configuration file : kerneos-config.xml
This file must be added in the META-INF directory of the war archive of your
application. See the example below :
Test
>Does absolutely nothing, it even doesn't exist
test.swf
In this example, one module is added on Kerneos. The name of the corresponding
swf file must be set, as well as a name for the module and a description. If the
module needs services to reach a java server side, just add them here.
Don't forget to add entries for these services in WEB-INF/flex/services-config.xml
of your webapp.
For the Kerneos services (loginService and moduleService) the channel ref must be
set to "my-graniteamf-kerneos". This channel is overloaded when Kerneos is loaded.
Nota :
------
Instead of specify the swfFile attribute, you can specify the url one as the following
example :
Yahoo
Yahoo search engine.
http://www.yahoo.fr
The goal is to be allowed to load any web page in as a module.
#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#
#| |#
#| HOWEVER, each time you move from a tab that owns an url, when you come back on it, |#
#| the url is reloaded. |#
#| |#
#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#|#
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
