Leçon 2 : Création et annotation de la source Java de votre application

Création d'une interface Java

Créez une interface Java™ pour définir les méthodes que votre application implémentera et les opérations qu'elle rendra accessibles en tant que service Web. Utilisez l'assistant de code pour ajouter des annotations SCA à votre interface.

Cliquer avec le bouton droit sur le projet SCA que vous avez créé à la leçon précédente, et sélectionnez Nouveau > Interface. L'assistant Interface Java s'ouvre.
Dans la zone Package, tapez helloworld. Dans la zone Nom, tapez HelloService. Cliquez sur Terminer. Un fichier source d'interface appelé HelloService.java est créé.
Ajoutez une méthode à l'interface. Après la ligne public interface HelloService {, ajoutez la méthode suivante à l'interface :
```
public String sayHello(String name);
```
Ajoutez l'annotation @Remotable avant la ligne public interface HelloService {. Lorsque vous ajoutez cette annotation, l'éditeur signale une erreur. Cliquez sur l'erreur pour ouvrir l'assistant de code et ajouter une instruction d'importation du package org.osoa.sca.annotations contenant le code de l'annotation. Cliquez deux fois sur Importer 'Remotable' dans l'invite de l'assistant de code. En ajoutant l'annotation @Remotable, vous indiquez que le service associé à cette interface sera accessible aux clients distants. Ainsi, un client ne faisant pas partie du même domaine SCA (par exemple, un client Web) sera en mesure d'accéder au service fourni par l'application.

Enregistrez la mise à jour de HelloService.java. La vue Explorateur de projets et votre code d'interface doivent maintenant ressembler à ceci :

package helloworld;

import org.osoa.sca.annotations.Remotable;

@Remotable
public interface HelloService {

	public String sayHello(String name);
	
}

Création du code d'implémentation

Vous allez créer une classe Java afin d'implémenter le service que vous êtes en train de créer. L'implémentation contiendra des méthodes conformes aux opérations de l'interface HelloService. Vous allez également utiliser l'annotation SCA @Service pour indiquer que la classe est une implémentation d'un service SCA et pour désigner l'interface dans laquelle sont décrites les opérations mises à disposition par le service que vous créez.

Faites un clic droit sur le package helloworld, sous le dossier src, et sélectionnez Nouveau > Classe. Dans la zone Nom de l'assistant Classe Java, entrez HelloServiceImpl. Cliquez sur Terminer. Le fichier source HelloServiceImpl.java s'ouvre dans l'éditeur Java.
Ajoutez la méthode sayHello à HelloServiceImpl.java. sayHello est la méthode définie dans l'interface HelloService. Ajoutez le code suivant après la ligne : public class HelloServiceImpl {
```
    public String sayHello(String name) {
        return "Hello, " + name + "!";
    }
```
Ajoutez l'annotation SCA @Service. L'annotation @Service indique que la classe est l'implémentation d'un service composant ; elle désigne également l'interface dans laquelle sont décrites les opérations qui seront accessibles via ce service. Ajoutez l'annotation suivante avant la ligne : public class HelloServiceImpl {
```
@Service
```
Comme vous l'avez fait avec l'annotation @Reference, cliquez sur l'icône d'erreur sur le côté gauche de l'éditeur pour ouvrir l'invite d'importation, puis cliquez deux fois sur Importer 'Service'(org.osoa.sca.annotations) pour importer le module d'annotations @Service.
Incluez dans l'annotation en l'éditant la classe d'interface de service Ajoutez ce qui suit juste après l'annotation @Service pour spécifier l'interface qui décrit les opérations assurées par le service.
```
(helloworld.HelloService.class)
```
Votre fichier HelloServiceImpl.java est à présent complet et doit ressembler à ceci :
```
package helloworld;

import org.osoa.sca.annotations.Service;


@Service (helloworld.HelloService.class)
public class HelloServiceImpl{

    public String sayHello(String name) {
        return "Hello, " + name + "!";
    }
	
}
```
Enregistrez les changements.

Leçon 2 : Création et annotation de la source Java de votre application

Création d'une interface Java

Création du code d'implémentation

Récapitulatif de la leçon