Mudanças entre as edições de "Desenvolvedor"

Edição das 13h41min de 14 de maio de 2014

O documento de arquitetura orienta o desenvolvimento no padrão do PJe: Acessar

O documento de gerenciamento de configuração traz orientações para a produção e guarda de artefatos e liberação de versões: Acessar

Alguns procedimentos necessários para o desenvolvimento no PJe:

Conteúdo

1 Pré-requisitos para ser desenvolvedor no PJe
2 Configuração do ambiente de desenvolvimento
3 Desenvolvimento
4 Gerando Deploy
5 Interfaces para extensão do sistema
- 5.1 Interfaces disponibilizadas
- 5.2 Desenvolvimento de ponto de extensão
6 Interoperabilidade
- 6.1 Modelo Nacional de Interoperabilidade - MNI
- 6.2 Serviços disponíveis pelo Web Service do MNI (MNI Versão 2.1)
7 Flyway
8 Catálogo de serviços

Pré-requisitos para ser desenvolvedor no PJe

Os pré-requisitos exigidos são:

Conhecimento da linguagem de programação Java (nível de conhecimento mínimo: de intermediário a avançado).
Conhecimento de persistência com JPA e Hibernate (nível de conhecimento mínimo: básico).
Conhecimento da linguagem SQL do banco de dados PostgreSQL (nível de conhecimento mínimo: básico).
Conhecimento de JSF (nível de conhecimento mínimo: básico).
Conhecimento de JBoss Seam 2.2 (nível de conhecimento mínimo: básico).
Habilidade de uso com a ferramenta Eclipse (nível de conhecimento mínimo: nível básico).

Os pré-requisitos desejáveis são:

Habilidade de uso com a ferramenta Maven (nível de conhecimento mínimo: nível básico).
Habilidade de uso com as ferramentas Git e GitLab (nível de conhecimento mínimo: noções gerais).
Conhecimento do servidor de aplicação JBoss 5.1 (nível de conhecimento mínimo: básico).
Conhecimento de padrões de projeto (design patterns) (nível de conhecimento mínimo: básico).
Conhecimento de jBPM (nível de conhecimento mínimo: noções gerais).
Habilidade de uso com a ferramenta de controle de demandas JIRA (nível de conhecimento mínimo: noções gerais).
Ter tido algum contato de uso com o sistema PJe.

Configuração do ambiente de desenvolvimento

A seguir, algumas instruções para instalação do ambiente de desenvolvimento.

Roteiro para Instalação e Configuração do Sistema Operacional

Recomenda-se o uso do Ubuntu para as máquinas de desenvolvimento, visto que seu desempenho é bastante superior ao do MS-Windows

Procure usar uma interface leve para o ambiente de trabalho. Uma alternativa interessante pode ser obtida em:

$ sudo apt-get install gnome-session-fallback

Recomenda-se a atualização do driver gráfico a partir de https://01.org/linuxgraphics/downloads/2013/intelr-linux-graphics-installer-version-1.0.1

Roteiro para Instalação do Java (Sistema Linux 64 bits)

Oracle JDK

Recomenda-se a instalação do Oracle JDK em função de padronização com o JDK para sistema operacional MS-Windows e com o procedimento demonstrado em http://www.cnj.jus.br/wikipje/images/e/ec/CorrecaoCertificadoCNJ.mp4
Certifique-se que sua versão é de 64 bits

$ file /sbin/init

Verifique se há alguma versão do Java instalada

$ java -version

Se houver um Open JDK instalado, remova-o:

$ sudo apt-get purge openjdk-\*

Crie uma pasta para instalação do Java

$ sudo mkdir -p /usr/local/java

Faça o download do JRE e do JDK, ambos compatíveis com Linux 64 bits

Copie os arquivos baixados para a pasta criada

$ cd ~/Downloads
$ sudo -s cp -r arquivoJDK.tar.gz /usr/local/java
$ sudo -s cp -r arquivoJRE.tar.gz /usr/local/java

Ajuste as permissões e descompacte os arquivos

$ cd /usr/local/java
$ sudo -s chmod a+x  arquivoJDK.tar.gz
$ sudo -s chmod a+x  arquivoJRE.tar.gz
$ sudo -s tar -xvzf arquivoJDK.tar.gz
$ sudo -s tar -xvzf arquivoJRE.tar.gz

Edite e acescente as informações sobre o Java no arquivo profile

$ sudo gedit /etc/profile

Trecho a ser inserido no arquivo profile

JAVA_HOME=/usr/local/java/seuJDK
PATH=$PATH:$HOME/bin:$JAVA_HOME/bin
JRE_HOME=/usr/local/java/seuJRE
PATH=$PATH:$HOME/bin:$JRE_HOME/bin
export JAVA_HOME
export JRE_HOME
export PATH

Informe a localização do Java para o sistema

$ sudo update-alternatives --install "/usr/bin/java" "java" "/usr/local/java/seuJRE/bin/java" 1 
$ sudo update-alternatives --install "/usr/bin/javac" "javac" "/usr/local/java/seuJDK/bin/javac" 1
$ sudo update-alternatives --install "/usr/bin/javaws" "javaws" "/usr/local/java/seuJRE/bin/javaws" 1

Informe o Java padrão para o sistema

$ sudo update-alternatives --set java /usr/local/java/seuJRE/bin/java
$ sudo update-alternatives --set javac /usr/local/java/seuJDK/bin/javac
$ sudo update-alternatives --set javaws /usr/local/java/seuJRE/bin/javaws

Atualize o path

$ . /etc/profile

Verifique a instalação

$ java -version
$ javac -version

Reinicialize o sistema e a instalação estará concluída

OpenJDK

$ sudo apt-get purge openjdk* icedtea* 
$ sudo apt-get install openjdk-7-demo openjdk-7-jdk openjdk-7-jre openjdk-7-jre-headless icedtea-7-jre-jamvm icedtea-7-plugin 
$ update-java-alternatives -l 
$ sudo update-java-alternatives -s java-1.7.0-openjdk-amd64

Roteiro para Configuração do Navegador Firefox

Crie um link simbólico para no diretório de plugins do Firefox /usr/lib/firefox-addons/plugins para /usr/local/java/seuJRE/lib/amd64/libnpjp2.so

$ sudo ln -sv /usr/local/java/seuJRE/lib/amd64/libnpjp2.so /usr/lib/firefox-addons/plugins

No menu Ferramentas, selecione complementos (add-ons) > plugins > Java (TM) plugin > sempre ativar

Roteiro para Instalação e Configuração do Cliente para Certificados Digitais

Há vários modelos de eToken. Neste roteiro são tratados o eToken Pro Aladdin e o eToken GD Starsign. Para verificar o modelo de seu eToken, conecte-o em uma USB e use o comando:

$ lsusb

Para eToken Pro Aladdin:

Baixe o arquivo em http://vqv.com.br/cnj/libhal1_0.5.14-8_amd64.deb e instale-o

$ cd ~/Downloads
$ sudo dpkg -i libhal1_0.5.14-8_amd64.deb

Baixe http://vqv.com.br/cnj/cliente-safenet.tar.gz

Descompacte, ajuste as permissões e execute o script de instalação

$ cd ~/Downloads
$ tar -zvxf cliente-safenet.tar.gz
$ chmod 700 install_SafenetAuthenticationClient-8.1.0-4_amd64.deb.sh 
$ sudo ./install_SafenetAuthenticationClient-8.1.0-4_amd64.deb.sh 
$ sudo apt-get -f install

Crie os links simbólicos para as bibliotecas necessárias

$ cd /usr/lib 
$ sudo ln -sv /usr/lib64/libeToken.so /usr/lib/libeToken.so.8 
$ sudo ln -sv /usr/lib64/libeTokenUI.so /usr/lib/libeTokenUI.so.8

Acesse uma instalação do PJe. Na primeira tentativa, você será solicitado a selecionar o driver. Escolha /usr/lib64/libeToken.so

Para eToken Giesecke & Devrient Starsign:

Baixe http://vqv.com.br/cnj/SafenetAuthenticationClient-8.1.0-4_amd64.deb

Instale o cliente

$ cd ~/Downloads
$ sudo dkpg -i SafenetAuthenticationClient-8.1.0-4_amd64.deb
$ sudo apt-get -f install

Na primeira vez que acessar o PJe, selecionar o driver

/usr/lib/libaetpkss.so.3.0.2528

Para alternar entre diferentes tipos de eTokens

Renomeie o driver, insira o próximo eToken e carregue o PJe.

Ao acessar o PJe, você será solicitado a escolher um novo driver.

Selecione conforme o tipo de eToken, conforme explicado anteriormente.

Roteiro para Instalação do JBoss 5.1

Baixar e instalar (descompactar) o JBoss 5.1.0.GA (download em http://www.jboss.org/jbossas/downloads/).

Alternativamente, usar o Jboss pré-configurado fornecido pela equipe de desenvolvimento do PJe ...

Na pasta server\pje\lib do Jboss, copie o driver jdbc do Postgres, e do Oracle, se for o caso

Verifique mais adiante no roteiro de instalação do Eclipse as configurações necessárias para uso do Jboss no Eclipse

Para usar o JDK7, é preciso configurar o Jboss, conforme trecho de código a seguir:

Na pasta \server\pje\conf\bootstrap, arquivo profile.xml (<parameter class="java.io.File">)

	<bean name="AttachmentStore" class="org.jboss.system.server.profileservice.repository.AbstractAttachmentStore">
	   <constructor>
             <parameter class="java.io.File">
                <inject bean="BootstrapProfileFactory" property="attachmentStoreRoot" />
             </parameter>     
          </constructor>
	</bean>

Roteiro para Instalação e Configuração do Sistema Gerenciador de Banco de Dados (desenvolvimento)

Instalação do SGBD postgres

Execute o seguinte comando no terminal

$ sudo apt-get install postgresql pgadmin3

Geração de uma senha conhecida para o usuário padrão postgres

Alterar a senha do usuário postgres no sistema operacional

$ sudo passwd postgres

Alternar para o usuário postgres

$ su postgres

Alterar a senha do usuário postgres no SGBD

$ psql -c "ALTER USER postgres WITH PASSWORD 'nova_senha'" -d template1

Acessar o SGBD usando o cliente pgAdmin III para certificação de que o SGBD está acessível

Ajuste de max_prepared_transactions

Configurar max_prepared_transactions no arquivo postgresql.conf valorado com 10

Atenção! Reinicialize o SGBD para que a alteração tenha efeito

$ locate postgresql.conf
$ cd /etc/postgresql/9.1/main
$ sudo gedit postgresql.conf

No MS-Windows,o arquivo fica em: C:\Program Files\PostgreSQL\9.3\data

Atenção! Retire o caractere de comentário # do início da linha

Substituir #max_prepared_transactions=0 por max_prepared_transactions=10

Criação da base de dados

Criar três bases de dados (pje, pje_bin e pje_log) com os seguintes parâmetros configurados, na aba Definition

encoding: LATIN1
template: template0
collation: C
character type: C

Restauração dos dumps

Restaurar os dumps das três bases com a seguinte instrução

$ pg_restore -U postgres -h localhost -v -Fc -d nome_base arquivo.dump

Criação dos Datasources

Criar um arquivo xxxxxx-ds.xml para definição dos datasources, conforme exemplificado a seguir. Observe que cada datasource tem um jndi-name.

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE datasources
    PUBLIC "-//JBoss//DTD JBOSS JCA Config 1.5//EN"
    "http://www.jboss.org/j2ee/dtd/jboss-ds_1_5.dtd">

<datasources>

	<xa-datasource>
		<jndi-name>PJE_DESCANSO_DS</jndi-name>
		<xa-datasource-class>org.postgresql.xa.PGXADataSource</xa-datasource-class>
		<xa-datasource-property name="ServerName">localhost</xa-datasource-property>
		<xa-datasource-property name="PortNumber">5432</xa-datasource-property>
		<xa-datasource-property name="DatabaseName">pje</xa-datasource-property>
		<new-connection-sql>set search_path = public, acl, core, client, criminal, jt</new-connection-sql>
		<user-name>postgres</user-name>
		<password>postgres</password>
		<min-pool-size>3</min-pool-size>
		<max-pool-size>10</max-pool-size>
		<track-connection-by-tx />
		<metadata>
			<type-mapping>PostgreSQL 8.0</type-mapping>
		</metadata>
	</xa-datasource>

	<xa-datasource>
		<jndi-name>PJE_DESCANSO_BIN_DS</jndi-name>
		<xa-datasource-class>org.postgresql.xa.PGXADataSource</xa-datasource-class>
		<xa-datasource-property name="ServerName">localhost</xa-datasource-property>
		<xa-datasource-property name="PortNumber">5432</xa-datasource-property>
		<xa-datasource-property name="DatabaseName">pje_bin</xa-datasource-property>
		<new-connection-sql>set search_path = public, client, core</new-connection-sql>
		<user-name>postgres</user-name>
		<password>postgres</password>
		<min-pool-size>3</min-pool-size>
		<max-pool-size>10</max-pool-size>
		<track-connection-by-tx />
		<metadata>
			<type-mapping>PostgreSQL 8.0</type-mapping>
		</metadata>
	</xa-datasource>

	<xa-datasource>
		<jndi-name>PJE_DESCANSO_LOG_DS</jndi-name>
		<xa-datasource-class>org.postgresql.xa.PGXADataSource</xa-datasource-class>
		<xa-datasource-property name="ServerName">localhost</xa-datasource-property>
		<xa-datasource-property name="PortNumber">5432</xa-datasource-property>
		<xa-datasource-property name="DatabaseName">pje_log</xa-datasource-property>
		<new-connection-sql>set search_path = public</new-connection-sql>
		<user-name>postgres</user-name>
		<password>postgres</password>
		<min-pool-size>3</min-pool-size>
		<max-pool-size>10</max-pool-size>
		<track-connection-by-tx />
		<metadata>
			<type-mapping>PostgreSQL 8.0</type-mapping>
		</metadata>
	</xa-datasource>

</datasources>

Outras informações sobre a instalação e configuração do SGBD (ambiente de produção)

Instalação do Sistema gerenciador de banco de dados

Roteiro para Instalação do Eclipse e de seus plugins

Baixar (http://www.eclipse.org/downloads/) e descompactar o Eclipse Kepler (Eclipse IDE for Java EE Developers)

Atenção! Ao instalar plugins ou gerar/configurar a chave para acesso ao GIT, sempre reinicialize a IDE, mesmo que não seja solicitado

Ajustar as preferências do Eclipse conforme instruções em Preferências do Eclipse

Aumentar o tamanho máximo do heap space para 1024 MB. Essa configuração pode ser feita no arquivo eclipse.ini com a alteração do valor -Xmx de 512m (padrão) para 1024m, conforme exemplo a seguir:

Gerar um par de chaves SSH para acessar o repositório Git do PJe, conforme instruções em Geração do Par de Chaves

Configurar no GitLab a chave pública gerada no passa anterior, conforme instruções em Configuração da Chave Pública no Servidor Git

Gerar uma cópia Git local do repositório do PJe conforme descrito em Obtendo a cópia do repositório do PJe

Criar um projeto a partir do repositório clonado no item anterior, conforme instruções em Criando o projeto a partir do repositório clonado

Configurar o acesso ao artfactory do CNJ no arquivo setting.xml, conforme instruções em Dependências do Maven

Remover as validações desnecessárias, conforme descrito em Removendo as validações desnecessárias

Adicionar o servidor Jboss ao Eclipse

Adicionar o pje-web ap Jboss

Ativar o Jboss

Se todos os procedimentos foram executados sem erros, seu ambiente está pronto

Preferências do Eclipse

Ir ao menu “Window > Preferences” e configurar as seguintes preferências do Eclipse:

Desmarcar limite de console: Window->Prferences->Debug/Run Console->Limit Console Output

Adicionar o JDK e remover as JREs existentes (A JDK pode ser obtida através do site da Oracle]. Antes de clicar no botão "Add" da imagem acima, faça o download e instale a JDK. Depois, adicione através do botão "Add", apontando para a pasta raiz onde o JDK foi instalado.

Ir para início do Roteiro para Instalação do Eclipse e de seus plugins

Obtendo a cópia do repositório do PJe

Atenção! Para obter uma cópia do PJe é necessário que um par de chaves SSH tenha sido gerado e configurado no servidor Git

Clonar o repositório por meio da funcionalidade “Clone Git Repository”, na aba Git Repositories na perspectiva Git do Eclipse. Na primeira clonagem é possível, dependendo da instalação do Eclipse, que sejam apresentadas duas janelas de diálogo seguidas solicitando confirmações. Confirme ambas

Deixar todos os branchs selecionados e clicar em “Next”

Escolher a pasta onde o repositório será clonado e clicar em “Next” (por exemplo: C:\TreinamentoPJE\Ambiente\projetos\pje)

Ir para início do Roteiro para Instalação do Eclipse e de seus plugins

Criando o projeto a partir do repositório clonado

Atenção! Antes de criar o projeto, deve ter sido realizada a clonagem do repositório do PJe

Ir para a perspectiva Java EE e clicar com o botão direito no Project Explorer

Selecionar o caminho onde foi clonado o repositório do GIT, no passo anterior (por exemplo: C:\TreinamentoPJE\Ambiente\projetos\pje)

Selecionar todos os pom’s listados e clicar em “Next”

Clicar em "Finish"

Atenção! A partir desse momento o download das dependências gerenciadas pelo Maven será iniciado. 
Na primeira criação de projeto, em função da grande quantidade de dependências, o processo levará aproximadamente 30 minutos

Ir para início do Roteiro para Instalação do Eclipse e de seus plugins

Dependências do Maven

Atenção! O arquivo settings.xml possui as configurações de acesso ao artfactory do CNJ.

Adicionar o arquivo settings.xml ao diretório .m2, cujo conteúdo segue exemplificado no trecho de código a seguir (insira seu login e senha do artifactory)

<?xml version="1.0" encoding="UTF-8"?>
<settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd" 
xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <servers>
   <server>
     <username>seu login</username>
     <password>sua senha</password>
     <id>central</id>
   </server>
   <server>
     <username>seu login</username>
     <password>sua senha</password>
     <id>snapshots</id>
   </server>
   <server> 
       <id>pje-descanso</id> 
       <username>postgres</username> 
       <password>P123456.</password> 
   </server>
 </servers>
 <profiles>
   <profile>
     <repositories>
       <repository>
         <snapshots>
           <enabled>false</enabled>
         </snapshots>
         <id>central</id>
         <name>repo</name>
         <url>http://www.cnj.jus.br/artifactory/repo</url>
       </repository>
       <repository>
         <snapshots />
         <id>snapshots</id>
         <name>repo</name>
         <url>http://www.cnj.jus.br/artifactory/repo</url>
       </repository>
     </repositories>
     <pluginRepositories>
       <pluginRepository>
         <snapshots>
           <enabled>false</enabled>
         </snapshots>
         <id>central</id>
         <name>repo</name>
         <url>http://www.cnj.jus.br/artifactory/repo</url>
       </pluginRepository>
       <pluginRepository>
         <snapshots />
         <id>snapshots</id>
         <name>repo</name>
         <url>http://www.cnj.jus.br/artifactory/repo</url>
       </pluginRepository>
     </pluginRepositories>
     <id>artifactory</id>
   </profile>
   <profile> 
       <id>pje-descanso</id>
       <properties> 
           <flyway.serverId>pje-descanso</flyway.serverId> 
           <flyway.driver>org.postgresql.Driver</flyway.driver> 
           <flyway.url>jdbc:postgresql://localhost:5432/pje_homologacao_1g</flyway.url> 
       </properties> 
   </profile>
 </profiles>
 <activeProfiles>
   <activeProfile>artifactory</activeProfile>
 </activeProfiles>
</settings>

Clicar em UPDATE SETTINGS do "Window > Preferences > Maven" (verifique se o caminho do arquivo settings.xml está adequado a sua instalação):

Atualizar as dependências do Maven, agora com acesso ao artifactory do CNJ (sempre que necessário, atualizar as dependências do Maven)

Se ainda forem detectados problemas de dependência, executar procedimento de limpeza:

Ir para início do Roteiro para Instalação do Eclipse e de seus plugins

Removendo as validações desnecessárias

Clicar com o botão direito em cada um dos projetos e configurar as seguintes propriedades:

Ir para início do Roteiro para Instalação do Eclipse e de seus plugins

Criando um branch para iniciar a resolução de uma pendência (issue)

Verificar instruções do EGit;
Solicitar alteração do branch de trabalho para um novo branch, conforme abaixo:

Criar o branch novo, referenciando o nome da pendência a ser resolvida. Adicionalmente, para contemplar necessidade de diversos pedidos de integração devido às várias versões em uso do PJe, sugere-se acrescentar ao nome do branch novo o nome do branch base que se está usando para criar o branch. Por exemplo, PJEII-7249-master, ou PJEII-7249-stable, ou ainda PJEII-7249-1.4.6.x

Após finalizado o procedimento, terá sido criado o branch em seu repositório local.

Publicando a aplicação com Jboss

Na aba Servers, adicione um novo servidor;
Aponte o ambiente de execução (runtime environment) para o diretório da instalação do JBoss;
Copie e cole o arquivo de datasources “PJE-ds.xml” para o diretório “/server/default/deploy” contido na instalação do JBoss (Lembre-se de editar o arquivo XML conforme a necessidade).

Alterando parâmetros de performance do Jboss

Pode ser que o Eclipse fique com sua execução prejudicada devido a problemas de performance do Jboss. Se for esse o caso, para alterar os parâmetros de performance, realize um clique duplo no servidor Jboss e depois clique em "Open launch configuration":

Verifique os VM Arguments. Tente melhorar a performance do JBoss aumentando o Xms, Xmx e MaxPermSize. (atentar para orientações disponíveis no manual de instalação - Xms = 1024m, Xmx = 1024 e MaxPermSize=256 )

Usuários para acessar sua instância do PJE

Para “zerar” as senhas dos usuários no banco de dados, executar o método main da classe RegistraSenha (após configurar acesso ao banco):

Instalando e configurando o FileSync

O FileSync é um plugin que executa no Eclipse, permitindo a 13.1. sincronização de arquivos mantidos por ele (leia http://marketplace.eclipse.org/content/filesync). Instale o plugin a partir do Eclipse em “Help > Eclipse Marketplace”:

Após a instalação, clicar com o botão direito no projeto que contém o ponto de início de execução (pje-web), selecionar "Properties" e localizar o item “File synchronization”. Clicar em “Add Folder” e adicionar a pasta /src/main/webapp:

Abrir a pasta incluída, selecionar “Excluded” e clicar em “Edit”:

Clicar no botão “Add Multiple” do “Exclusion patterns”, selecionar todos os arquivos do WEB-INF exceto a pasta XHTML e clicar em “OK”:

Informar em "Default target folder" o caminho do .war:

Comandos GIT

Para começar, leia a documentação existente em http://www.atlassian.com/git. Estude primeiro o tutorial para iniciantes (http://www.atlassian.com/git/tutorial).

Exemplos de comandos:

FETCH ( atualizar um branch local com o código do servidor remoto):

COMMIT

RESET (apagar as modificações feitas em um branch local):

Lembre-se:
Quando você desfaz suas modificações com reset git, não existe maneira alguma de recuperá-las. 
Leia: http://www.atlassian.com/git/tutorial/undoing-changes#!reset .

Depois, deve ser realizado um PULL a fim de recuperar a versão mais atualizada do branch.

Observações

O vídeo que descreve a configuração do projeto no Eclipse está um pouco desatualizado, mas é importante dar uma olhada:

Teclas de atalho do Eclipse:
- CTRL + SHIT + F = Identar
- CTRL + SHIT + R = Localizar arquivo ou classe
- CTRL + SHIT + T = Localizar tipo (classe)
- CTRL + SHIT + O = Imports
- CTRL + D = Apagar linha
- CTRL + F = Localizar
- CTRL + O = Localizar métodos e atributos dentro de um arquivo

A seguir, alguns vídeos que auxiliam na configuração do ambiente.

Download das ferramentas

Para iniciar o desenvolvimento do sistema PJE, faça o download das ferramentas necessárias através do endereço: https://wwwh.cnj.jus.br/svn/projeto_pje/trunk/ambiente (atualizar - svn não mais necessário)

Veja como fazer o download: Vídeo

Instalando o Postgres

Para instalar o Postgres, execute o instalador que foi baixado anteriormente deixando as opções sugeridas. Na etapa de definição de senha de administrador, informe "P123456."

Criando base de dados

Crie duas bases de dados: PJE_1_4 e PJE_1_4_BIN, sendo a primeira necessária para armazemanento dos dados do PJE e a segunda para armazenamento dos documentos dos processos gerados pelo PJE.
Veja como fazer a criação da base de dados: Vídeo

Restaurando base de dados

Após criar as bases, vamos copiar os dados e a estrutura do banco de desenvolvimento e restaurá-lo em nosso banco local.
Veja como: Vídeo

Configurando o Eclipse

Tutorial que ensina as principais configurações para desenvolvimento no eclipse, tais como: configuração do MAVEN, download de códigos-fonte no SVN, configuração do JBoss, configuração de HotDeploy (atualizar - svn não mais necessário) Vídeo

Gerando certificados CACERTS

O PJE faz uso de alguns webServices para consulta de dados, como receita federal e OAB. Para que ele consiga executar as pesquisas, é necessário gerar alguns certificados. Veja no vídeo como fazê-lo: Vídeo

Desenvolvimento

Criando entidades

Neste vídeo, demonstraremos como criar entidades para armazenamento de dados no padrão exigido pelo PJE.
Script de criação das tabelas usadas no exemplo: Arquivo:Script criacao tabelas.txt
Vídeo

Criando DAO

Neste vídeo, demonstraremos como criar classes do tipo DAO para acesso aos dados de uma entidade. Uma DAO acessa dados de somente uma entidade.
Vídeo

Criando manager

Neste vídeo, demonstraremos como criar classes do tipo "manager" para adicionarmos regras de negócio e validações antes de persistir os dados de uma entidade. Managers controlam regras de negócio de apenas uma entidade.
Vídeo

Criando action

Neste vídeo, demonstraremos como criar classes do tipo "action" que farão o controle de uma determinada tela.
Vídeo

Criando páginas

Neste vídeo, demonstraremos como criar páginas "xhtml" de pesquisa e edição de registros.
Vídeo

Gerando Deploy

Vídeos que orientam o desenvolvedor sobre como gerar corretamente o deploy do PJE:

Deploy através do MAVEN: Vídeo
Deploy manualmente: Vídeo

Interfaces para extensão do sistema

O sistema PJe evidentemente não é capaz de contemplar toda a variedade de implementações existentes dadas pelos tribunais para os diversos serviços auxiliares ou acessórios que orbitam a atividade jurisdicional. Alguns desses serviços são intensamente próximos da atividade judicial, outros são um pouco mais distantes. O traço mais comum é, no entanto, a grande possibilidade de variação de implementação dada por cada um dos tribunais.

Em razão dessa apreensão, é imprescindível permitir que algumas atividades sejam implementadas pelo tribunal interessado e conectadas ao PJe. Essa conexão pode ser feita de várias maneiras, desde serviços web até implementações mais internas. Uma alternativa de implementação mais rápida é a construção de componentes Seam que possam ser instalados no PJe para sua posterior utilização em nós de fluxos.

A presente página apresenta as interfaces inicialmente disponibilizadas para algumas das atividades mais críticas do sistema e disponibiliza um projeto de exemplo contendo uma implementação vazia para uma dessas interfaces.

Interfaces disponibilizadas

Na versão 1.0 do projeto de interfaces do PJe, serão disponibilizadas interfaces para as seguintes atividades:

verificação de prevenção em relação a outros sistemas - br.jus.cnj.pje.extensao.VerificadorPrevencaoExterna
envio e recebimento de informações para sistema de diário eletrônico - br.jus.cnj.pje.extensao.PublicadorDJE
envio e recebimento de comunicações postais - br.jus.cnj.pje.extensao.ConectorECT
verificação de recolhimento de custas processuais - br.jus.cnj.pje.extensao.VerificadorCustasProcessuais

Essas interfaces estão definidas no projeto pje-interfaces-1.0.0, empacotadas em um arquivo JAR que deve ser utilizado na implementação da interface. A documentação relativa a cada uma das interfaces pode ser consultada diretamente na WIKI e nos arquivos de documentação do desenvolvedor.

Desenvolvimento de ponto de extensão

O desenvolvimento do ponto de extensão do PJe passa pelas seguintes etapas:

implementação da interface como componente Seam
definição de arquivo components.xml em que o componente da interface seja inicializado pela classe que a implementa
empacotamento do ponto de extensão, devendo ser identificadas as bibliotecas de dependência para instalação junto ao PJe
instalação do ponto de extensão e concretização de seus testes

Implementação da interface

O JBoss Seam 2.2.X permite que sejam criados componentes em pacotes autônomos, que podem ser posteriormente instalados em sistemas Seam. Uma vez instalados, esses componentes são inicializados juntamente com os demais componentes da aplicação e ficarão disponíveis para injeção e utilização pela aplicação. Para tanto, basta implementar a interface e, no arquivo components.xml, definir o componente e a classe que o implementa. O exemplo que será apresentado versará sobre a implementação da interface de verificação de prevenção. Essa interface tem uma só função definida:


String[] verificaPrevencao(String processoOrigem, int codClasse, int codAssuntoPrincipal, int[] codAssuntos, String[] nomesAutores, String[]  
documentosAutores, String[] nomesReus, String[] documentosReus)

A implementação pode adotar o mecanismo que o tribunal implementador entender mais adequado, desde arquivo de sistemas até serviços Web. Neste exemplo, vamos adotar um mecanismo de verificação em banco de dados.

<code class="java">
@Name("verificadorPrevencaoExterna")
@Scope(ScopeType.APPLICATION)
@Install(precedence=Install.APPLICATION)
@Startup
public class VerificadorPrevencaoExemplo implements VerificadorPrevencaoExterna {

	@In(create=true)
	private DataSource prevencaoDS;

	@Override
	public String[] verificaPrevencao(String processoOrigem, int codClasse, int codAssuntoPrincipal, int[] codAssuntos, String[] nomesAutores, 
           String[] documentosAutores, String[] nomesReus, String[] documentosReus){
		List<String> nomesPartes = new ArrayList<String>();
		nomesPartes.addAll(Arrays.asList(nomesAutores));
		nomesPartes.addAll(Arrays.asList(nomesReus));
		
		List<String> documentosPartes = new ArrayList<String>();
		documentosPartes.addAll(Arrays.asList(documentosAutores));
		documentosPartes.addAll(Arrays.asList(documentosReus));
		
		int numeroNomes = nomesPartes.size();
		int numeroDocumentos = documentosPartes.size();
		
		String qStr = buildQuery(numeroDocumentos, numeroNomes);
		
		Connection con = ds.getConnection();
		PreparedStatement pstmt = con.prepareStatement(qStr);
		pstmt.setInt(1, codClasse);
		pstmt.setInt(2, codAssuntoPrincipal);
		for(int i = 3; i < 3 + numeroNomes; i++){
			pstmt.setString(i, nomesPartes.get(i - 3));
		}
		for(int i = 3 + numeroNomes; i < 3 + numeroNomes + numeroDocumentos; i++){
			pstmt.setString(i, documentosPartes.get(i - numeroNomes - 3));
		}
		ResultSet rs = pstmt.executeQuery();
		List<String> ret = new ArrayList<String>();
		while(rs.next()){
			ret.add(new String(rs.getString(1)));
		}
		return ret.toArray(new String[]{});
	}
	
	private String buildQuery(int numeroNomes, int numeroDocumentos){
		StringBuilder sb = new StringBuilder("SELECT DISTINCT p.numero FROM tb_processo AS p " +
				"JOIN tb_partes AS par ON par.processo = p.numero " +
				"JOIN tb_pessoa AS pes ON par.cod_pessoa = pes.cod_pessoa WHERE p.classe = ?1 AND p.assunto = ?2 AND ");
		sb.append("(pes.nome IN (");
		for(int i = 3; i < 3 + numeroNomes; i++){
			sb.append("?" + i);
			if(i != (2 + numeroNomes)){
				sb.append(", ");
			}
		}
		sb.append(") OR pes.documento IN (");
		for(int i = 3 + numeroNomes; i < (3 + numeroNomes+ numeroDocumentos); i++){
			sb.append("?" + i);
			if(i != (2 + numeroNomes + numeroDocumentos)){
				sb.append(", ");
			}
		}
		sb.append("))");
		return sb.toString();
	}
}
</code>

Atentem que essa implementação é *apenas um exemplo*, não se tendo buscado assegurar características mais profundas de segurança ou de performance. No exemplo, não são considerados os assuntos que não o principal e é adotada estratégia única de verificação de prevenção em que é imprescindível a coincidência de classe e assunto, ainda que a posição das partes não seja relevante.

Definição do arquivo `components.xml`

No exemplo acima, vimos que a implementação reclama a existência de uma fonte de dados. Essa fonte deve ser definida no arquivo components.xml.

<code class="xml">
<?xml version="1.0" encoding="UTF-8"?>
<components xmlns="http://jboss.com/products/seam/components"
	xmlns:core="http://jboss.com/products/seam/core"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://jboss.com/products/seam/core http://jboss.com/products/seam/core-2.2.xsd 
                 http://jboss.com/products/seam/components http://jboss.com/products/seam/components-2.2.xsd">
	<factory name="prevencaoDS" value="DATASOURCE_CONFIGURADO_NO_SERVIDOR_DE_APLICACAO" scope="application"/>
</components>
</code>

Empacotamento do ponto de extensão

O ponto de extensão deve ser empacotado em um arquivo JAR contendo a(s) classe(s) necessárias à implementação e, aindaa seguinte estrutura mínima:

arquivo seam.properties vazio na raiz do arquivo JAR
pasta META-INF contendo o arquivo components.xml

A par desse arquivo JAR, é imprescindível que o desenvolvedor do ponto de extensão identifique as bibliotecas de que depende, devendo, especialmente, verificar:

se a biblioteca já faz parte do servidor de aplicação JBoss em que o PJe será instalado
se a biblioteca já faz parte das bibliotecas de que o próprio PJe depende (WEB-INF/lib)
se há alguma incompatibilidade entre as bibliotecas dependentes e aquelas já utilizadas no PJe

Cumpridos os passos acima, o desenvolvedor deverá elaborar um pacote ZIP contendo o JAR do ponto de extensão e os JARs das bibliotecas extras necessárias.

Instalação do ponto de extensão

A instalação do ponto de extensão é feita inserindo nos JARs contidos no pacote ZIP acima referido na pasta WEB-INF/lib do PJe. Sua utilização será feita por meio de injeção em componentes Seam do PJe ou indiretamente, em chamadas EL contidas em arquivos xhtml. Tanto a injeção quanto o uso em XHTMLs será feita por meio do nome padronizado de cada interface, que é o nome CamelCase da interface, sendo a primeira letra minúscula.

Interoperabilidade

Sistemas externos podem ser integrados ao PJe através de serviços disponíveis no padrão MNI. Pode-se acessar a lista de serviços através da instalação do PJe no tribunal, complementendo o endereço de acesso inicial do PJe com o trecho "intercomunicacao?wsdl". Esse é um acesso disponível em toda instalação do PJe, ou seja, se o seu tribunal tem o PJe instalado, essa verificação teste pode ser realizada no seu próprio ambiente.

Para auxiliar na integração com outros sistemas, o PJe dispõe de outros serviços web. Pode-se acessar a lista de serviços através da instalação do PJe no tribunal, complementendo o endereço de acesso inicial do PJe com o trecho "ConsultaPJe?wsdl". Esse é um acesso disponível em toda instalação do PJe, ou seja, se o seu tribunal tem o PJe instalado, essa verificação teste pode ser realizada no seu próprio ambiente.

Modelo Nacional de Interoperabilidade - MNI

O MNI estabelece as bases para o intercâmbio de informações de processos judiciais e assemelhados entre os diversos órgãos de administração da Justiça, e como base para a implementação das funcionalidades pertinentes no âmbito do sistema processual de que trata o TCOT n.º 073/2009 e o acordo TAC n.º 58/2009.

Serviços disponíveis pelo Web Service do MNI (MNI Versão 2.1)

Em construção

PJe versão 1.4.6.4

Das cinco operações previstas, quatro estão implementadas (ver detalhes em http://www.cnj.jus.br/intercomunicacao-2.1):

consultarAvisosPendentes - consulta a existência de avisos de comunicação processual pendentes. Pode ser específica em relação a uma parte representada ou relativa aos processos em que o consultante opera como órgão de representação processual (MP, defensoria pública, advocacia pública, escritório de advocacia e advogado). Seu retorno contém os dados básicos, uma lista dos avisos pendentes de conhecimento pelo consultante. Caso não haja aviso pendente o retorno será uma lista vazia.
consultarTeorComunicacao - consulta o teor específico de uma comunicação processual pendente
consultarProcesso - consulta um processo judicial se o nível de sigilo interno permitir a consulta pelo requerente. Os documentos do processo poderão encerrar apenas binários encriptados cuja chave será fornecida na consultaTeorComunicacao, caso haja intimação pendente para o documento transferido.
entregarManifestacaoProcessual - permite a entrega de manifestação processual, por órgão de representação processual ou por advogado, e a entrega de petição inicial. Retorna o os dados básicos, o número do protocolo, a data da operação e, se bem sucedida, documento PDF contendo o recibo.

Autenticação

Como pré-requisito para usá-las, deve ser feita a autenticação dos clientes por meio da inscrição na Receita Federal (CNPJ ou CPF) extraída de certificados digitais ICP-Brasil. O protocolo de comunicação deve ser https.

Os órgãos de representação processual (MP, Defensoria Pública, Advocacia Pública e escritório de advocacia) são tratados no PJe como procuradorias. O cliente pode utilizar o certificado institucional ou pessoal. No primeiro caso, o CPF do responsável deve ser o mesmo que está associado à procuradoria cadastrada no PJe.

Referências:

Em construção

Comunicação entre instâncias do PJe

Utilização por órgãos externos

Órgãos externos ao tribunal objeto da instalação do PJe

Migração

Uso temporário

Flyway

O Flyway é um sistema de versionamento de banco de dados. Funciona como um plugin no maven. Anteriormente, no PJe, vinha se usando o Flyway através do projeto pje-dbmanager, mas, devido às dificuldades de integração de código e integração de banco em projetos separados, optou-se, na versão 1.5.0, por reintegrar os scripts do dbmanager ao PJe e utilizar o flyway direto no maven desse momento em diante. Para configurá-lo no projeto PJe, deve-se modificar o arquivo .m2/settings.xml e acrescentar os seguintes parâmetros:

<servers>
...
  <server>
    <id>pje-descanso</id>
    <username>postgres</username> 
    <password>123456.</password>
  </server>
...
</servers>
<profiles>
...
  <profile>
    <id>pje-descanso</id>
    <properties>
      <flyway.serverId>pje-descanso</flyway.serverId>
      <flyway.driver>org.postgresql.Driver</flyway.driver>
      <flyway.url>jdbc:postgresql://localhost:5432/pje_1_4</flyway.url>
    </properties>
  </profile>
...
</profiles>

No início do trecho de arquivo, a configuração do <server> é a autenticação que deve ser utilizada para o <profile> de nome "pje-descanso", configurado mais abaixo. A configuração do <profile> contém o servidor (<flyway.serverId>) onde será executada a atualização, estabelecendo o driver para acesso ao banco (<flyway.driver>) e o endereço onde o banco se encontra (<flyway.url>).

Para atualizar a base, execute o comando "mvn flyway:migrate -P pje-descanso" através do eclipse, conforme imagem abaixo:

onde "pje-descanso" é o <flyway.serverId> definido no arquivo de configuração acima descrito.

A atualização de banco em versões anteriores é feita através do projeto dbmanager (que não mais existe a partir da 1.5.0), utilizando a classe atualizarBase.java. Ela deve ser executada diretamente pelo eclipse.

Catálogo de serviços

O PJe faz uso de comunicação com diversos serviços externos, como consulta à Receita Federal, consulta a instituições financeiras, consulta à OAB. Os endereços desses serviços ficam centralizados no Catálogo de serviços. Para ter acesso ao catálogo, os tribunais devem solicitar ao CNJ através do email G-lideres.PJE@cnj.jus.br.

Mudanças entre as edições de "Desenvolvedor"

Edição das 13h41min de 14 de maio de 2014

Conteúdo

Pré-requisitos para ser desenvolvedor no PJe

Configuração do ambiente de desenvolvimento

Roteiro para Instalação e Configuração do Sistema Operacional

Roteiro para Instalação do Java (Sistema Linux 64 bits)

Oracle JDK

OpenJDK

Roteiro para Configuração do Navegador Firefox

Roteiro para Instalação e Configuração do Cliente para Certificados Digitais

Para eToken Pro Aladdin:

Para eToken Giesecke & Devrient Starsign:

Para alternar entre diferentes tipos de eTokens

Roteiro para Instalação do JBoss 5.1

Roteiro para Instalação e Configuração do Sistema Gerenciador de Banco de Dados (desenvolvimento)

Instalação do SGBD postgres

Geração de uma senha conhecida para o usuário padrão postgres

Ajuste de max_prepared_transactions

Criação da base de dados

Restauração dos dumps

Criação dos Datasources

Outras informações sobre a instalação e configuração do SGBD (ambiente de produção)

Roteiro para Instalação do Eclipse e de seus plugins

Preferências do Eclipse

Obtendo a cópia do repositório do PJe

Criando o projeto a partir do repositório clonado

Dependências do Maven

Removendo as validações desnecessárias

Criando um branch para iniciar a resolução de uma pendência (issue)

Publicando a aplicação com Jboss

Alterando parâmetros de performance do Jboss

Usuários para acessar sua instância do PJE

Instalando e configurando o FileSync

Comandos GIT

Observações

Download das ferramentas

Instalando o Postgres

Criando base de dados

Restaurando base de dados

Configurando o Eclipse

Gerando certificados CACERTS

Desenvolvimento

Criando entidades

Criando DAO

Criando manager

Criando action

Criando páginas

Gerando Deploy

Interfaces para extensão do sistema

Interfaces disponibilizadas

Desenvolvimento de ponto de extensão

Implementação da interface

Definição do arquivo components.xml

Empacotamento do ponto de extensão

Instalação do ponto de extensão

Interoperabilidade

Modelo Nacional de Interoperabilidade - MNI

Serviços disponíveis pelo Web Service do MNI (MNI Versão 2.1)

PJe versão 1.4.6.4

Autenticação

Comunicação entre instâncias do PJe

Utilização por órgãos externos

Migração

Flyway

Catálogo de serviços

Ferramentas pessoais

Espaços nominais

Variantes

Visualizações

Ações

Pesquisar

Navegação

Informações Gerais

Aplicativos PJe

Manuais

Suporte

Ferramentas

Definição do arquivo `components.xml`