spring integration

Integração Primavera

Estende o modelo de programação Spring para oferecer suporte aos conhecidos Padrões de Integração Corporativa. Spring Integration permite mensagens leves em aplicativos baseados em Spring e oferece suporte à integração com sistemas externos por meio de adaptadores declarativos. Esses adaptadores fornecem um nível mais alto de abstração em relação ao suporte do Spring para comunicação remota, mensagens e agendamento. O principal objetivo do Spring Integration é fornecer um modelo simples para a construção de soluções de integração empresarial, mantendo ao mesmo tempo a separação de interesses que é essencial para a produção de código testável e de manutenção.

O uso do Spring Framework incentiva os desenvolvedores a codificar usando interfaces e usar injeção de dependência (DI) para fornecer um Plain Old Java Object (POJO) com as dependências necessárias para executar suas tarefas. O Spring Integration leva esse conceito um passo adiante, onde os POJOs são conectados usando um paradigma de mensagens e os componentes individuais podem não estar cientes de outros componentes no aplicativo. Esse aplicativo é construído através da montagem de componentes reutilizáveis ​​​​de granularidade fina para formar um nível mais alto de funcionalidade. Com um design cuidadoso, esses fluxos podem ser modularizados e também reutilizados em um nível ainda mais elevado.

Além de conectar componentes refinados, o Spring Integration oferece uma ampla seleção de adaptadores de canal e gateways para comunicação com sistemas externos. Adaptadores de canal são usados ​​para integração unidirecional (envio ou recebimento); gateways são usados ​​para cenários de solicitação/resposta (entrada ou saída).

Instalação e primeiros passos

Primeiro, você precisa de dependências em seu POM/Gradle:

< dependency >
    < groupId >org.springframework.integration</ groupId >
    < artifactId >spring-integration-core</ artifactId >
</ dependency >

que também é puxado transitivamente se você lidar com adaptadores de canal de protocolo de destino. Por exemplo, para suporte ao Apache Kafka, você precisa apenas disto:

< dependency >
    < groupId >org.springframework.integration</ groupId >
    < artifactId >spring-integration-kafka</ artifactId >
</ dependency >

Para anotações ou configuração Java DSL você precisa habilitar o Spring Integration no contexto do aplicativo:

 @ EnableIntegration
@ Configuration
public class ExampleConfiguration {
    
}

Código de Conduta

Consulte nosso Código de Conduta.

Relatando vulnerabilidades de segurança

Por favor, consulte nossa política de segurança.

Documentação

O Spring Integration mantém documentação de referência (publicada e fonte), páginas wiki do GitHub e uma referência de API. Também existem guias e tutoriais para projetos Spring.

Verificando e construindo

Para verificar o projeto e compilar a partir da fonte, faça o seguinte:

 git clone git://github.com/spring-projects/spring-integration.git
cd spring-integration
./gradlew clean test

or

./gradlew clean testAll

Este último executa testes adicionais (aqueles anotados com @LongRunningIntegrationTest ); é um teste mais completo, mas leva muito mais tempo para ser executado.

Os resultados do teste são capturados em build/reports/tests/test (ou .../testAll ) em cada módulo (em formato HTML).

Adicione --continue ao comando para realizar uma compilação completa, mesmo se houver falhas nos testes em alguns módulos; caso contrário, a construção será interrompida após a conclusão dos módulos atuais que estão sendo construídos.

NOTA: Embora o Spring Integration seja executado com Java SE 17 ou superior, um compilador Java 17 é necessário para construir o projeto.

Para criar e instalar jars no cache local do Maven:

 ./gradlew build publishToMavenLocal

Para construir a API Javadoc (os resultados estarão em build/api ):

 ./gradlew api

Para construir a documentação de referência (os resultados estarão em build/site ):

 ./gradlew antora

Para construir uma distribuição completa, incluindo arquivos zip -dist , -docs e -schema (os resultados estarão em build/distributions ):

 ./gradlew dist

Usando Eclipse ou Spring Tool Suite (com BuildShip Plugin)

Se você tiver o plugin BuildShip instalado,

Arquivo -> Importar -> Gradle -> Projeto Gradle existente

Usando Eclipse ou Spring Tool Suite (quando o plugin BuildShip não está instalado)

Para gerar metadados do Eclipse (arquivos .classpath e .project, etc.), faça o seguinte:

 ./gradlew eclipse

Depois de concluído, você poderá importar os projetos para o Eclipse normalmente:

Arquivo -> Importar -> Geral -> Projetos existentes no espaço de trabalho

Navegue até o diretório raiz 'spring-integration' . Todos os projetos devem ser importados sem erros.

Usando o IntelliJ IDEA

Para importar o projeto para o IntelliJ IDEA:

Arquivo -> Abrir... -> e selecione build.gradle no diretório raiz do projeto de integração de primavera

Diretrizes

Consulte também Diretrizes para Colaboradores.

Recursos

Para obter mais informações, visite o site do Spring Integration em: https://spring.io/projects/spring-integration