Recherche
Historique de la page
...
MANIFEST.MF
| Remarque |
|---|
Fichier {_}{color} {note} Fichiersrc/main/resources/META-INF/MANIFEST.MF dans le projet {note} |
Le
...
fichier
...
MANIFEST.MF
...
est
...
le
...
fichier
...
de
...
configuration
...
principal
...
d'un
...
plugin
...
OSGI.
Exemple :
| Bloc de code |
|---|
Exemple :Manifest-Version: 1.0 Bundle-ManifestVersion: 1 Bundle-Name: Nuxeo Sample project Bundle-SymbolicName: org.orioai.nuxeo.workflow;singleton:=true Bundle-Version: 1.0.0 Bundle-Vendor: ORI-ORI.org Provide-Package: org.orioai.nuxeo.workflow Require-Bundle: org.nuxeo.runtime, org org.nuxeo.ecm.core.api, org org.nuxeo.ecm.core, org org.nuxeo.ecm.webapp.core Nuxeo-Component: OSGI-INF/core-types-contrib.xml, OSGI OSGI-INF/actions-contrib.xml, OSGI OSGI-INF/orioaiworkflow-service-contrib.xml, OSGI OSGI-INF/wsdl-orioaiworkflow-contrib.xml, OSGI OSGI-INF/orioainuxeo2xml-service-contrib.xml, OSGI OSGI-INF/xsl-orioainuxeo2xml-contrib.xml Bundle-ClassPath: qname.jar Import-Package: javax.xml.namespace h2. Explications h3. Information générale sur le plugin | Bundle-SymbolicName | ID | | Bundle-Version | Version | | Bundle-Name | Nom | | Bundle-Vendor | Fournisseur | h3. Gestion de dépendances | Provide-Package | Chaîne de caractère qui devra être utilisé par des plugin qui seront dépendant de ce plugin | | Require-Bundle | Liste des plugins dont est dépendant le plugin courant. Cette liste influera sur l'ordre de chargement des plugins au démarrage de nuxeo | h3. Autres paramètres | Nuxeo-Component | Autres fichiers, appelés XML descriptor, de configuration du plugin. Ils servent à spécifier les points d'extension utilisés par le plugin et/ou à spécifier les points d'extension exposés par le plugin | | Bundle-ClassPath | Liste de répertoires ou de jar à charger pour la bonne exécution du plugin | | Import-Package | ??? | h1. {color:#000000}{_}XML descriptor{_}{color} {note} Fichiers |
Explications
Information générale sur le plugin
Bundle-SymbolicName | ID |
Bundle-Version | Version |
Bundle-Name | Nom |
Bundle-Vendor | Fournisseur |
Gestion de dépendances
Provide-Package | Chaîne de caractère qui devra être utilisé par des plugin qui seront dépendant de ce plugin |
Require-Bundle | Liste des plugins dont est dépendant le plugin courant. Cette liste influera sur l'ordre de chargement des plugins au démarrage de nuxeo |
Autres paramètres
Nuxeo-Component | Autres fichiers, appelés XML descriptor, de configuration du plugin. Ils servent à spécifier les points d'extension utilisés par le plugin et/ou à spécifier les points d'extension exposés par le plugin |
Bundle-ClassPath | Liste de répertoires ou de jar à charger pour la bonne exécution du plugin |
Import-Package | ??? |
XML descriptor
| Remarque |
|---|
Fichiers src/main/resources/OSGI-INF/*-contrib.xml dans le projet {note} |
Ce
...
sont
...
les
...
fichiers
...
spécifiés
...
dans
...
Nuxeo-Component
...
du
...
fichier
...
MANIFEST.MF
...
Ils
...
servent
...
à
...
spécifier
...
les
...
points
...
d'extension
...
utilisés
...
par
...
le
...
plugin
...
et/ou
...
à
...
spécifier
...
les
...
points
...
d'extension
...
exposés
...
par
...
le
...
plugin.
...
Par
...
convention
...
ils
...
sont
...
de
...
la
...
forme :
- *-contrib.xml
...
- quand
...
- ils
...
- servent
...
- à
...
- spécifier
...
- l'utilisation
...
- de
...
- points
...
- d'extension
...
- existants
...
- *
...
- -service-contrib.xml
...
- quand
...
- ils
...
- servent
...
- à
...
- spécifier
...
- de
...
- nouveaux
...
- points
...
- d'extension
...
Le
...
développement
...
des
...
points
...
d'extension
...
est
...
traité
...
dans ???
...
mais
...
voici
...
2
...
exemples
...
de
...
fichiers
...
XML
...
descriptor.
...
Exemple de core-types-contrib.xml
...
:
| Bloc de code |
|---|
<?xml version="1.0"?> <component name="org.orioai.nuxeo.workflow.core-types"> <extension target="org.nuxeo.ecm.core.schema.TypeService" point="schema"> <schema name="ori" src="schemas/ori.xsd" prefix="ori" /> </extension> <extension target="org.nuxeo.ecm.core.schema.TypeService" point="doctype"> <doctype name="File" extends="Document"> <schema name="common" /> <schema name="file" /> <schema name="dublincore" /> <schema name="uid" /> <schema name="files" /> <schema name="ori" /> <facet name="Downloadable" /> <facet name="Versionable" /> <facet name="Publishable" /> <facet name="Indexable" /> <facet name="Commentable" /> </doctype> </extension> </component> |
Explications
/component@name | Nom du composent. |
/component/extension@target | Nom du composant que l'on va étendre. Correspond au /component@name du point d'extension utilisé. |
/component/extension@point | Un composant peut contenir plusieurs points d'extension utilisables. On spécifie avec ce paramètre celui que l'on veut étendre. |
/component/extension/* | Liste des informations que l'on va passer un point d'extension que l'on étend. Cette liste est spécifique à chaque point d'extension. |
Exemple de orioaiworkflow-service-contrib.xml :
| Bloc de code |
|---|
h3. Explications | /component@name | Nom du composent. \\ Ce nom prend la forme d'une classe java mais il ne s'agit pas obligatoirement d'une classe. En effet, le plus souvent, on étend un point d'extension pour lui passer des paramètres de configuration. | | /component/extension@target | Nom du composant que l'on va étendre. Correspond au /component@name du point d'extension utilisé. | | /component/extension@point | Un composant peut contenir plusieurs points d'extension utilisables. On spécifie avec ce paramètre celui que l'on veut étendre. | | /component/extension/\* | Liste des informations que l'on va passer un point d'extension que l'on étend. Cette liste est spécifique à chaque point d'extension. | h2. Exemple de orioaiworkflow-service-contrib.xml : <?xml version="1.0"?> <component name="org.orioai.nuxeo.workflow.OriOaiWorkflowService"> <implementation <implementation class="org.orioai.nuxeo.workflow.OriOaiWorkflowServiceMock" /> <service> <provide <service> <provide interface="org.orioai.nuxeo.workflow.OriOaiWorkflowService" /> </service> <documentation>explication sur le service</documentation> <extension-point name="wsUrl"> <documentation>explication sur le point d'extension</documentation> <object class="org.orioai.nuxeo.workflow.WsDescriptor" /> </extension-point> </component> h3. Explications | /component@name | Nom du composent. \\ Ce nom prend la forme d'une classe java. Une bonne pratique consiste à utiliser ici la même valeur que pour |
Explications
/component@name | Nom du composent. |
...
/component/implementation@class |
...
Classe |
...
java |
...
concrète |
...
implémentant |
...
le |
...
service |
...
/component/service/provider@interface |
...
Nom |
...
de |
...
l'interface |
...
java |
...
qui |
...
est |
...
implémentée |
...
par |
...
/component/implementation@class |
...
/component/documentation |
...
Texte |
...
d'information |
...
sur |
...
le |
...
service. |
...
Il |
...
est |
...
utile |
...
pour |
...
les |
...
personnes |
...
qui |
...
seront |
...
amenés |
...
à |
...
travailler |
...
avec |
...
votre |
...
point |
...
d'extension. |
...
Il |
...
est |
...
utilisé |
...
pour |
...
la |
...
génération |
...
automatique |
...
de |
...
la |
...
documentation |
...
de |
...
référence |
...
sur |
...
les |
...
points |
...
d'extension. |
...
/component/extension-point@name |
...
Nom |
...
du |
...
point |
...
d'extension |
...
offert |
...
par |
...
le |
...
composant. |
...
Il |
...
peut |
...
y |
...
avoir |
...
plusieurs |
...
balises |
...
/component/extension-point |
...
/component/extension-point/documentation |
...
Texte |
...
d'information |
...
sur |
...
le |
...
point |
...
d'extension |
...
/component/extension-point/object |
...
Nom |
...
du |
...
bean |
...
qui |
...
contiendra |
...
les |
...
configurations |
...
du |
...
point |
...
d'extension |
...
lorsqu'il |
...
sera |
...
étendu. |
|
Déploiement fragment
| Remarque |
|---|
Fichiers | | h1. {color:#000000}{_}Déploiement fragment{_}{color} {note} Fichierssrc/main/resources/OSGI-INF/deployment-fragment.xml dans le projet {note} |
Une
...
application
...
web
...
java
...
classique
...
a
...
des
...
fichiers
...
de
...
configuration
...
qui
...
sont
...
lus
...
au
...
lancement
...
du
...
serveur
...
d'applications.
...
De
...
même,
...
les
...
fichiers
...
de
...
ressources
...
ou
...
les
...
librairies
...
sont
...
lus
...
au
...
lancement.
...
Ceci
...
n'est
...
pas
...
compatible
...
avec
...
la
...
notion
...
de
...
plugin.
...
En
...
effet,
...
un
...
plugin
...
se
...
matérialise
...
par
...
un
...
simple
...
fichier
...
jar
...
qui
...
sera
...
chargé
...
en
...
fonction
...
des
...
règles
...
de
...
dépendances
...
définies
...
dans
...
le
...
fichier
...
MANIFEST.MF.
...
Il
...
peut
...
néanmoins
...
nécessiter
...
des
...
ressources
...
spécifiques
...
ou
...
une
...
configuration
...
particulière
...
de
...
l'application
...
java
...
qui
...
la
...
contient.
...
Le
...
fichier
...
deployment-fragment.xml
...
permet
...
justement
...
de
...
spécifier
...
comment
...
le
...
plugin
...
va
...
adapter
...
l'environnement
...
d'exécution
...
java
...
dans
...
lequel
...
il
...
sera
...
appelé.
Exemple :
| Bloc de code |
|---|
Exemple :<?xml version="1.0"?> <fragment> <extension target="application#MODULE"> <module> <java>$\{bundle.fileName}</java> </module> </extension> <extension target="web#CONTEXT-PARAM"> <context-param> <param-name>org.jboss.seam.core.init.debug</param-name> <param-value>true</param-value> </context-param> </extension> <install> <!-- Unzip the war template --> <unzip from="$\{bundle.fileName\}" to="/"> <include>nuxeo.war/**</include> </unzip> <!-- Append .properties files --> <delete path="orioainuxeodir.tmp" /> <mkdir path="orioainuxeodir.tmp" /> <unzip from="$\{bundle.fileName\}" to="orioainuxeodir.tmp"> <include>**/*.properties</include> </unzip> <append from="orioainuxeodir.tmp/OSGI-INF/l10n/messages.properties" to="nuxeo.war/WEB-INF/classes/messages.properties" addNewLine="true" /> <append from="orioainuxeodir.tmp/OSGI-INF/l10n/messages_fr.properties" to="nuxeo.war/WEB-INF/classes/messages_fr.properties" addNewLine="true" /> <delete path="orioainuxeodir.tmp" /> </install> </fragment> h2. Explications : h1. \| |
Explications :
/fragment/extension@target |
...
Nuxeo utilise des fichiers templates (dans le répertoire nuxeo.ear/OSGI-INF/templates). |
...
la propriété |
...
/fragment/extension@target |
...
permet |
...
de |
...
cibler |
...
ce |
...
fichier |
...
(partie |
...
avant |
...
le |
...
# |
...
sans |
...
l'extension |
...
.xml) |
...
ainsi |
...
que |
...
le |
...
positionnement |
...
dans |
...
ce |
...
fichier |
...
(partie |
...
après |
...
le |
...
# |
...
qui |
...
permet |
...
de |
...
pointer |
...
sur |
...
une |
...
balise |
...
de |
...
la |
...
forme |
...
% |
...
{MODULE} |
...
%) |
...
/fragment/extension/ |
...
* | Portion de XML qui sera intégrée dans le fichier template |
/fragment/install | Contient du code de type ant permettant de faire certaines actions sur le système de fichiers de l'application. |
...
de |
...
notre |
...
projet |
...
vers |
...
le |
...
répertoire |
...
d'exécution |
...
de |
...
l'application |
...
java |
...
|
Note à propos de ${bundle.fileName} |
...
${bundle.fileName} |
...
correspond |
...
au |
...
fichier |
...
jar |
...
du |
...
plugin |
...
courant |
...
Nuxeo.war
| Remarque |
|---|
| }
répertoire src/main/resources/nuxeo.war dans le projet {note} Ce répertoire contient |
Ce répertoire contient l'ensemble
...
des
...
fichiers
...
(pages
...
JSP
...
en
...
.xtml,
...
image,
...
etc.)
...
qui
...
seront
...
déployés
...
dans
...
le
...
répertoire
...
d'exécution
...
de
...
l'application
...
Web
...
de
...
nuxeo
...
grâce
...
au
...
deployment-fragment.xml.
...
Vue d'ensemble
Gestion des contenus