Projeto de exemplos em Java 7+ com Spring MVC
O Projeto de exemplos em Java 7+ com Spring MVC mostra como usar o Rest PKI junto com Web PKI em uma aplicação web Java 7+ usando framework Spring MVC. É hospedado no GiHub em:
https://github.com/LacunaSoftware/PkiSuiteSamples/tree/master/java/springmvc
Executando o projeto
- Download do projeto ou clonar o repositório
- Instale o JDK 21 ou superior.
- No prompt de comando, navegue até a pasta
java/springmvce execute o comandogradlew bootRun(no Linux./gradlew bootRun). Se você estiver usando Windows, você pode, alternativamente, clicar duas vezes no arquivoRun-Sample.bat. - Depois de ver a mensagem "Started Application in x.xxx seconds" (a porcentagem na tela não atingirá 100%), abra o browser e vá para a URL http://localhost:60695
Mapa do projeto
Esta seção lista tem onde encontrar as partes relevantes em cada amostra de recurso no projeto.
Autentificação com certificado digital
- Controller: AuthenticationRestController
- Views:
- index.html (Javascript em authentication-form.js)
- success.html
- failed.html
Assinatura PAdES com arquivo já no servidor
- Controller: PadesSignatureRestController
- Views:
- index.html (Javascript em signature-form.js)
- signature-info.html
Assinatura PAdES com arquivo enviado pelo usuário
Após o upload do arquivo (que é grosseiramente implementado apenas para fins de demonstração em UploadController) e da view index.html, o fluxo de controle é o mesmo que na amostra Assinatura PAdES com arquivo já no servidor,
mas com parâmetro de URL userfile preenchidos.
Assinatura conjunta PAdES
Após o fluxo de controle da amostra Assinatura PAdES com arquivo já no servidor está concluído e o link Co-sign with another certificate é clicado, o mesmo fluxo de controle é
repetido, mas agora com parâmetro de URL userfile preenchidos.
Marcas PAdES
Esse recurso é demonstrado como uma configuração opcional no Assinatura PAdES com arquivo já no servidor, amostra que por padrão começa comentada. Para ativá-lo, remova o comentário da linha a seguir PadesSignatureRestController:
signatureStarter.addPdfMark(PadesVisualElements.getPdfMark(1));
Tente mudar o argumento para a função getPdfMark()para ver diferentes configurações de marcas PDF.
O código relevante está no arquivo PadesVisualElements,
função getPdfMark().
Assinatura PAdES usando chave do servidor
- Controller: PadesServerKeyRestController
- View: index.html
Abrir/validar uma assinatura PAdES existente
- Controller: OpenPadesRestController
- View: index.html
Versão para impressão
Após o fluxo de controle da amostra Assinatura PAdES com arquivo já no servidor estar concluído e o link Download a printer-friendly version of the signed file ser clicado, o fluxo
vai para o controller PrinterFriendlyPadesRestController com o parâmetro de URL fileId preenchido.
Assinatura CAdES com arquivo já no servidor
- Controller: CadesSignatureRestController
- Views:
- index.html (Javascript em signature-form.js)
- signature-info.html
Assinatura CAdES com upload do arquivo pelo usuário
Depois que o upload do arquivo (que é grosseiramente implementado apenas para fins de demonstração no UploadController) e na view index.html é feito,
o fluxo de controle é o mesmo que na amostra CAdES signature with file already on server, mas com o parâmetro de URL userfile preenchido.
Assinatura conjunta CAdES
Após o fluxo de controle da amostra CAdES signature with file already on server está concluído e o link Co-sign with another certificate é clicado, o mesmo fluxo de controle é
repetido, mas agora com parâmetro de URL cmsfile preenchidos.
Abrir/validar uma assinatura CAdES existente
- Controller: OpenCadesRestController
- Views:
- index.html
- data-file.html (envio do arquivo assinado, quando a assinatura é destacada)
Assinatura XML do documento inteiro
- Controller: XmlSignatureRestController
- Views:
- index.html (Javascript em signature-form.js)
- signature-info.html
Assinatura XML de um elemento
- Controller: XmlNFeSignatureRestController
- Views:
- index.html (Javascript em signature-form.js)
- signature-info.html
Assinatura XAdES de um elemento
Demonstrado no exemplo de diploma digital, que assina os elementos DadosDiploma e DadosRegistro com a política ICP-Brasil XAdES AD-RT e, por fim, o documento inteiro com a política AD-RA:
- Controller: XmlDiplomaSignatureRestController
- Views:
Abrir/validar assinatura de um arquivo XML existente
- Controller: OpenXmlRestController
- View: index.html
Lote de assinatura PAdES
- Controller: BatchPadesSignatureRestController
- View: index.html
- Javascript: batch-signature-rest-form.js
Lote de assinaturas CAdES
- Controller: BatchCadesSignatureRestControler
- View: index.html
- Javascript: batch-signature-rest-form.js