Criando um projeto para um Resource adapter

Os Resource Adapters utilizam a plataforma JAVA como tecnologia base para seu desenvolvimento. O primeiro passo ao desenvolver um novo resource adapter, é preparar um projeto Maven para que você possa desenvolvê-lo.

Os passos a seguir demonstram as configurações necessárias para a criação de um projeto Maven que posteriormente se tornará o artefato necessário para o seu Resource Adapter.

1. Download do certiciado da Sectigo RSA Domain Validation Secure Server CA:

A depender da versão de sua JDK, pode ser que seja necessário a instalação do certificado SSL utilizado pelo repositório Maven do Blazon, sendo assim faça o donwload do certificado no link a seguir:

https://repo.blazon.im/utils/blazon.im.der

2 - Adicione o certificado em sua keystore:

keytool -keystore $JAVA_HOME/jre/lib/security/cacerts -import -file blazon.im.der

3 - Crie um projeto Maven utilizando a IDE de sua preferência.

4 - Abra o pom.xml do projeto Maven criado e adicione as configurações de repositório Maven do Blazon:

<profiles>
		<profile>
			<id>blazon-blazon-public-artifacts</id>
			<activation>
				<activeByDefault>true</activeByDefault>
			</activation>
			<repositories>
				<repository>
					<id>blazon-blazon-public-artifacts</id>
					<url>https://mavenrepo.blazon.im/maven/blazon-public-artifacts/</url>
				</repository>
			</repositories>
		</profile>
	</profiles>

5 - Adicione a dependência da API Java de Resource adapter:

<dependencies>

        ...

		<dependency>
			<groupId>com.blazon.resourceadapter</groupId>
			<artifactId>resource-adapter-api</artifactId>
			<version>1.0.0</version>
		</dependency>

        ...

	</dependencies>

6 - Adicione as opções de build ao seu projeto:

<build>
            <finalName>__NOME__DO__ARTEFATO__</finalName>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.8.0</version>
                    <configuration>
                        <source>8</source>
                        <target>8</target>
                    </configuration>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-jar-plugin</artifactId>
                    <version>3.0.2</version>
                    <configuration>
                        <outputDirectory>${project.basedir}/artifact/components/</outputDirectory>
                    </configuration>
                </plugin>
                <plugin>
                    <artifactId>maven-resources-plugin</artifactId>
                    <version>3.0.1</version>
                    <executions>
                        <execution>
                            <id>copy-resources</id>
                            <phase>compile</phase>
                            <goals>
                                <goal>copy-resources</goal>
                            </goals>
                            <configuration>
                                <outputDirectory>
                                    ${project.basedir}/artifact/settings/</outputDirectory>
                                <resources>
                                    <resource>
                                        <directory>src/main/resources</directory>
                                        <excludes>
                                            <exclude>*.sh</exclude>
                                        </excludes>
                                    </resource>
                                </resources>
                            </configuration>
                        </execution>
                        <execution>
                            <id>copy-sh-file</id>
                            <phase>compile</phase>
                            <goals>
                                <goal>copy-resources</goal>
                            </goals>
                            <configuration>
                                <outputDirectory>${project.basedir}/artifact/</outputDirectory>
                                <resources>
                                    <resource>
                                        <directory>src/main/resources</directory>
                                        <includes>
                                            <include>*.sh</include>
                                        </includes>
                                    </resource>
                                </resources>
                            </configuration>
                        </execution>
                    </executions>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-dependency-plugin</artifactId>
                    <executions>
                        <execution>
                            <id>copy-dependencies</id>
                            <phase>package</phase>
                            <goals>
                                <goal>copy-dependencies</goal>
                            </goals>
                            <configuration>
                                <includeScope>runtime</includeScope>
                                <outputDirectory>
                                    ${project.basedir}/artifact/components</outputDirectory>
                            </configuration>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </build>

7 - Após as configurações indicadas anteriormente, faça o build do seu projeto, utilizando o comando abaixo:

mvn clean compile package

Após o processo de compilação, um diretório artifact será criado, contendo os artefatos necessários para o futuro deploy do Resource adapter.