Page History
...
I dokumentet benyttes følgende notationer:
Markering af scripts og kommandoer.
Markering af advarsler
Markering af referencer til filer.
1.2 Målgruppe og læsevejledning
...
- Java Developer Kit 6.0_x
- Et passende udviklingsmiljø
- Maven 3.x
- MySQL database 5.1.x
- JBoss AS6
...
Kildekode
Kildekoden er placeret i et github-repository:
...
Koden checkes ud på følgende måde:
% git |
---|
...
...
1.2 Byggemiljø
Stamdataprojektet anvender Maven som byggesystem [MAVEN]. Strukturen følger de generelle anbefalinger for Maven projekter, og er struktureret med en parent pom.xml og en projekt pom.xml fil for hvert underprojekt.
...
Opret en bruger i mysql databasen med bruger navn ”sdm” og password ”papkasse”:
% mysql -uroot -p Enter password: <root password til mysql>[2] mysql> CREATE USER 'sdm'@'localhost' IDENTIFIED BY 'papkasse'; |
---|
Stamdataservicens database og tabeller oprettes via:
db/schema.sql db/batch_copy db/dynamic_views.sql |
---|
Sql filerne eksekveres på følgende måde:
% mysqladmin -u root create sdm_warehouse -p % mysql -u root -p Enter password: <root password til mysql> mysql> grant all privileges on sdm_warehouse.* to sdm@localhost identified by 'papkasse' with grant option; mysql> exit % mysql -u sdm sdm_warehouse < db/schema.sql -p Enter password: papkasse % mysql -u sdm sdm_warehouse < db/batch_copy.sql -p Enter password: papkasse % mysql -u sdm sdm_warehouse < db/dynamic_views.sql -p Enter password: papkasse |
---|
Det anbefales, at den nuværende navngivning af databasen bibeholdes. Ønsker man at etablere en database med et alternativt navn, skal dette tilrettes i modulernes konfigurationsfiler.
Bemærk, at ændringer i konfigurationsfilerne har systemmæssige konsekvenser, og derfor bør kun velovervejede ændringer committes. |
---|
...
Autogenereret kode
Start med at køre følgende:
% mvn clean install |
---|
Stamdataprojektet benytter JAX-WS i webservice snitfladerne i CPR-WS projektet.
Snitfladekoden er autogeneret og skal ved opdatering af de associererede WSDL filer opdateres med kommandoen:
% mvn generate-sources |
---|
Som bagvedliggende implementering af JAX-WS benyttes Oracle’s reference implementering. Denne kan konfigureres ved at ændre i filen
<CPR-modul>/…/WEB-INF/sun-jaxws.properties |
---|
...
Test
Installationen kan verificeres ved at eksekvere stamdataservicens test suite.
...
Testkoden er for hvert modul lokaliseret i:
src/test/java |
---|
Test suiten afvikles ved at udføre følgende kommando i projektroden:
% mvn test |
---|
Kommandoen kan også udføres under de individuelle moduler, hvorved kun undermodulets test udføres.
Installationen kan yderligere verificeres ved at udføre kommandoen:
% mvn verify |
---|
Denne kommando validerer code coverage og kode konventionerne for projektet.
...
Kode konventionerne følger reglerne defineret i filen:
config/checkstyle.xml |
---|
...
IDE
Stamdataservicen kan principielt udvikles i enhver Java IDE, der forstår Maven projekters opbygning.
...
I dette dokument beskrives kort opsætning for to af de pt. mest udbredte Java IDE’er: Eclipse og IntelliJ.
...
Eclipse
Eclipse er ikke født med Maven support, og det anbefales derfor, at man installerer m2eclipse inden stamdataservicen hentes ind i Eclipse:
...
[2] Root password til mysql sættes med følgende kommando:
% mysqladmin -u root password NEWPASSWORD |
---|