{"type":"doc","content":[{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-info","text":":info:","shortName":":info:"}},{"text":" Ramverket byggs med och för Java 17 och kräver att din utvecklingsmiljö har tillgång till detta.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"För att utveckla tjänster tillhandahåller ramverket en föräldra-artefakt som bör användas enligt:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n 4.0.0\n \n se.sundsvall.dept44\n dept44-service-parent\n [dept44-version att använda]\n \n se.sundsvall\n ett-api\n 0.1-SNAPSHOT\n \n ...\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"type":"emoji","attrs":{"id":"atlassian-info","text":":info:","shortName":":info:"}},{"text":" Ovanstående ","type":"text"},{"text":"pom.xml","type":"text","marks":[{"type":"code"}]},{"text":" tillsammans med en applikationsklass annoterad med ","type":"text"},{"text":"@ServiceApplication","type":"text","marks":[{"type":"code"}]},{"text":" och en main-metod, samt en ","type":"text"},{"text":"application.properties","type":"text","marks":[{"type":"code"}]},{"text":" liknande nedan utgör i sig ett skal för en fungerande tjänst:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"@ServiceApplication\npublic class MyApplication {\n\n public static void main(String[] args) {\n SpringApplication.run(MyApplication.class, args);\n }\n}","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":"openapi.name=my-api\nopenapi.title=My API\nopenapi.version=0.1","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Artefakten fungerar som en Maven-POM och ser därmed till att rätt versioner av de beroenden som ramverket tillhandahåller används, samt att viss gemensam konfiguration utförs. Den ser även till att ramverkets bas-starter (","type":"text"},{"text":"dept44-starter","type":"text","marks":[{"type":"code"}]},{"text":") alltid inkluderas i utvecklade tjänster. Utöver den är det fritt fram att inkludera ","type":"text"},{"text":"starters","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SK/pages/910163969"}}]},{"text":" efter behov.","type":"text"}]},{"type":"paragraph","content":[{"text":"Vidare aktiveras filtrering på resurser i katalogerna ","type":"text"},{"text":"src/main/resources","type":"text","marks":[{"type":"code"}]},{"text":" och ","type":"text"},{"text":"src/test/resources","type":"text","marks":[{"type":"code"}]},{"text":" så att man i resurserna kan använda platshållare på formatet ","type":"text"},{"text":"@propertyNamn@","type":"text","marks":[{"type":"code"}]},{"text":" , såsom till exempel ","type":"text"},{"text":"@project.version@","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Föräldra-artefakten konfigurerar även ett antal Maven-plugins:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"spring-boot-maven-plugin","type":"text","marks":[{"type":"code"}]},{"text":" - för att paketera applikationen/tjänsten","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"maven-resources-plugin","type":"text","marks":[{"type":"code"}]},{"text":" - för att hantera projekt-resurser","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"maven-surefire-plugin","type":"text","marks":[{"type":"code"}]},{"text":" - för att exekvera enhetstester","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"maven-failsafe-plugin","type":"text","marks":[{"type":"code"}]},{"text":" - för att exekvera integrationstester","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"build-helper-maven-plugin","type":"text","marks":[{"type":"code"}]},{"text":" - för att sätta upp extra källkods- och resursrötter för integrationstester - ","type":"text"},{"text":"src/integration-test/java","type":"text","marks":[{"type":"code"}]},{"text":" respektive ","type":"text"},{"text":"src/integration-test/resources","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"jacoco-maven-plugin","type":"text","marks":[{"type":"code"}]},{"text":" - för att säkerställa kodtäckning.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Utan extra konfiguration kommer ","type":"text"},{"text":"jacoco-maven-plugin","type":"text","marks":[{"type":"code"}]},{"text":" att applicera kodtäckningsregler för alla klasser, vilket kanske inte alltid är önskvärt. I det fallet kan man konfigurera undantag genom att lägga till följande i sin ","type":"text"},{"text":"pom.xml","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"...\n\n \n\t\torg.jacoco\n\t\tjacoco-maven-plugin\n\t\t\n\t\t\t\n\t\t\t\t**/my/package/FirstClassToExclude*\n\t\t\t\t**/my/package/ignored/**/*\n\t\t\t\n\t\t\n\t\n\n...","type":"text"}]}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"type":"hardBreak"},{"text":"Som regel används 85% (0.85) för kodradstäckning och 50% (0.5) för branch-täckning. Detta kan om så önskas överstyras genom att i sin ","type":"text"},{"text":"pom.xml","type":"text","marks":[{"type":"code"}]},{"text":" sätta properties ","type":"text"},{"text":"coverage.line.level","type":"text","marks":[{"type":"code"}]},{"text":" respektive ","type":"text"},{"text":"coverage.branch.level","type":"text","marks":[{"type":"code"}]},{"text":" till önskad täckningsgrad, t.ex 0.8 respektive 0.6.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Vill man generera JAR-filer innehållande källkod och JavaDoc-dokumentation för sin tjänst kan man i sin ","type":"text"},{"text":"pom.xml","type":"text","marks":[{"type":"code"}]},{"text":" sätta ","type":"text"},{"text":"maven.source.skip","type":"text","marks":[{"type":"code"}]},{"text":" respektive ","type":"text"},{"text":"maven.javadoc.skip","type":"text","marks":[{"type":"code"}]},{"text":" till ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". Som standard är dessa inaktiverade, d.v.s. satta till ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}],"version":1}

Browser not supported