Interfaces de Serviço na Prática

Transcrição

Luciano Oliveira
Sr. Instructor, Consultant
Global Field Services
Antes de começarmos…
Iniciando do princípio…
Interfaces de Serviço da Prática
2
© 2006 Progress Software Corporation
Let me tell you a story…
3
4
5
6
7
Agenda
Revisão da Arquitetura de Referência
OpenEdge®
Requisitos para Interfaces de Serviço
•
•
•
•
•
OpenEdge GUI
WebSpeed® UI
.NET™ UI
Web services
Sonic
8
Arquitetura de Referência OpenEdge®
Serviços
Serviços Corporativos
Corporativos
Serviços
Serviços de
de Negócio
Negócio
Acesso
Acesso aa Dados
Dados
Fontes
Fontes de
de Dados
Dados
9
Infra-estrutura Comum
Comum
Infra-estrutura
Apresentação
Apresentação
Interfaces de Serviço
De um perspectiva funcional…
Dispositivos
Dispositivos
Wireless
Wireless
Portal
Portal Web
Web B2C
B2C
Relató
órios
Relat
Relatórios
Corporativos
Corporativos
Quiosque
Quiosque de
de
Informaç
ções B2C
Informa
Informações
B2C
Camada
Camada de
de
Servi
ços de
ócio
Serviços
de Neg
Negócio
Aplicaç
ções de
Aplica
Aplicações
de
Back
Back Office
Office
API
API aberta
aberta
Serviç
ços de
Servi
Serviços
de
Colaboraç
ção B2B
Colabora
Colaboração
B2B
Integraç
ção A2A
Integra
Integração
A2A
10 © 2006 Progress Software Corporation
Interfaces de Serviço
… a um ponto de vista técnico
.NET
.NET CF
CF usando
usando
Web
Web Services
Services
OpenEdge
OpenEdge
WebSpeed
WebSpeed
Crystal
Crystal Xi
Xi usando
usando
proxy
proxy .NET
.NET
OpenEdge
OpenEdge
AppServer
AppServer
.NET
.NET usando
usando
proxy
proxy .NET
.NET
GUI
GUI
OpenEdge
OpenEdge
Web
Web Services
Services
Sonic
Sonic ESB
ESB
Sonic
Sonic MQ
MQ
Arquitetura de Referência OpenEdge – Interface de
Serviços
Interface de serviços e utilitários de ambiente
Entidades de
Negócio
Tarefas de
Negócio
Fluxos de
Negócio
Interface de Serviços - Definição
Uma Interface de Serviços é uma API que é
exposta ao mundo externo. Esta API serve
como uma ponte entre a camada de Serviços
de Negócio e as camadas de Apresentação
e/ou Integração.
Agenda
OpenEdge®
•
•
•
•
•
OpenEdge GUI
WebSpeed® UI
.NET™ UI
Web services
Sonic
Chamando a lógica de negócios
“Conectar” à lógica de negócios
Executar lógica de negócios
Passos adicionais
Gerenciamento de sessão
Gerenciamento de Contexto
Segurança
Auditoria
Serviço de Diretório
Chamando a lógica de negócios
Conecta à lógica de negócios
Gerenciamento de sessão
Gerenciamento de contexto
Verificações de segurança
Atividades de auditoria
Encontrar/iniciar lógica de negócio
Executar lógica de negócio
Responsabilidades do Cliente
Conexão ao AppServer™
• É preciso conectar ao AppServer?
• Como se conecta ao AppServer?
Contexto do cliente
• O cliente pode manter informações de sessão,
contexto ou segurança?
• Podemos controlar e confiar no contexto do lado
cliente?
Responsabilidades do Cliente
Segurança do cliente
• Como os clientes se autenticam?
• É possível tomar um token de sessão para validar a
identidade ou faz-se necessária a autenticação a cada
requisição?
• Podemos utilizar credencials de cliente (client principals)?
Suporte a ProDataSets
• O cliente pode enviar e receber estruturas do tipo
DataSet?
• O cliente pode enviar dados de tabelas Before/After?
Agenda
OpenEdge®
•
•
•
•
•
OpenEdge GUI
WebSpeed® UI
.NET™ UI
Web services
Sonic
OpenEdge GUI
Conexão direta ao AppServer
Pode manter contexto de cliente
• Login / ID da sessão
• Dados do Contexto
Suporta credenciais (principals) do cliente
Suporte nativo a ProDataSets
Escrito em ABL
Capaz de realizar chamadas assíncronas ao
AppServer
Interface de Serviços OpenEdge GUI
Conecta-se ao AppServer
Passa o Id da Sessione e outras informações
de contexto
Passa parâmetros para a requisição
• Pode conter DataSets
Recupera sessão/contexto
Verifica segurança
Retorna resultados ao cliente
• Pode conter DataSets
Interface de Serviços OpenEdge:
carfetchwhere.p
{autoedge/dscar.i}
{services/dscontext.i}
{services/dsnull.i}
DEFINE
DEFINE
DEFINE
DEFINE
DEFINE
DEFINE
INPUT
INPUT
INPUT-OUTPUT
OUTPUT
INPUT-OUTPUT
OUTPUT
PARAMETER
PARAMETER
PARAMETER
PARAMETER
PARAMETER
PARAMETER
pcEntityName
AS CHARACTER NO-UNDO .
pcOperationName AS CHARACTER NO-UNDO .
DATASET FOR dsContext .
DATASET FOR dsCar .
DATASET FOR dsNull .
pcExcStatus
AS CHARACTER NO-UNDO .
DEFINE VARIABLE hDataset AS HANDLE
NO-UNDO.
RUN support/proSIgateway.p (
INPUT "Car",
INPUT "fetchWhere",
INPUT-OUTPUT DATASET dsContext BY-REFERENCE,
OUTPUT DATASET-HANDLE hDataset,
INPUT-OUTPUT DATASET dsNull BY-REFERENCE,
OUTPUT pcExcStatus ) .
IF NOT pcExcStatus > "" THEN
DO:
DATASET dsCar:COPY-DATASET (hDataset) .
END.
RETURN .
/* service interface for customer SaveChanges */
DEFINE
DEFINE
DEFINE
DEFINE
INPUT PARAMETER pcEntityName
AS CHARACTER NO-UNDO.
INPUT PARAMETER pcOperationName AS CHARACTER NO-UNDO.
INPUT-OUTPUT PARAMETER DATASET-HANDLE phContext.
OUTPUT PARAMETER DATASET-HANDLE phOutputDataSet.
/* used for fetching data */
DEFINE INPUT-OUTPUT PARAMETER DATASET-HANDLE phDSCustomer.
/* used for updates
*/
DEFINE OUTPUT PARAMETER pcExcStatus
RUN restoreSessionAndContext
(INPUT-OUTPUT DATASET-HANDLE phContext BY-REFERENCE) .
RUN checkPermission
(INPUT pcEntityName,
INPUT pcOperationName,
OUTPUT lExecuteAllowed,
INPUT-OUTPUT DATASET-HANDLE phContext BY-REFERENCE) .
IF NOT lExecuteAllowed THEN LEAVE .
RUN getOperationDetails
OUTPUT hEntity,
OUTPUT cProcedureName,
OUTPUT lInputOutput) .
/* call method with appropriate INPUT-OUTPUT or OUTPUT parameters */
IF lInputOutput THEN DO:
RUN VALUE (cProcedureName) IN hEntity
(INPUT-OUTPUT DATASET-HANDLE phIODataSet BY-REFERENCE).
END.
ELSE DO:
(OUTPUT DATASET-HANDLE phOutputDataSet).
END .
RUN errorAndExceptionHandling (OUTPUT pcExcStatus) .
RETURN .
OpenEdge WebSpeed
Modelo cliente/servidor complexo
• Web browser – agente WebSpeed
• Código WebSpeed– camada de Serviços de Negócio
Datasets
• Não suportados em “telas” HTML
• Suportados em código WebSpeed
Sessão/contexto do cliente (em ambos os “clientes”)
• Login / Id da sessão
• Contexto do cliente
Escrito em ABL
Interface de Serviços OpenEdge WebSpeed
Mapeia requisições HTML a ABL
• Forms, variáveis de browser, parâmetros de URL,
cookies
• Pode precisar da criação de Before/After tables para
os ProDataSets
Conecta-se ao AppServer
• Ou executa a lógica de negócios na mesma sessão
Verifica segurança
Mapeia os resultados de volta para HTML
RUN setContext
(INPUT 'whereString':U,
INPUT cWhereString,
INPUT '':U).
RUN setContext
(INPUT 'batchSize':U,
INPUT piBatchSize,
INPUT '':U).
RUN callOperation
(INPUT 'Car':U,
INPUT 'fetchCar':U,
INPUT-OUTPUT DATASET dsContext BY-REFERENCE
OUTPUT DATASET dsCar,
INPUT-OUTPUT DATASET-HANDLE hNullDataSet
).
PROCEDURE callOperation […]
RUN checkPermission
OUTPUT lExecuteAllowed,
INPUT-OUTPUT DATASET-HANDLE phContext BY-REFERENCE) .
IF (NOT lExecuteAllowed) OR (phContext:ERROR = TRUE) THEN
RETURN.
RUN getOperationDetails
OUTPUT hEntity,
OUTPUT cProcedureName, /*fetchWhere/SaveChanges*/
OUTPUT lInputOutput) .
(INPUT-OUTPUT DATASET-HANDLE phIODataSet).
END.
ELSE DO:
(OUTPUT DATASET-HANDLE phOutputDataSet).
END . […]
Open Client .NET
Conecta-se ao AppServer através de proxies
Sessão/contexto do cliente
• Login / Id da Sessão
• Contexto do cliente
Suporte a Datasets
Escrito em C#, J#, VB.NET…
• Tipicamente as equipes de desenvolvimento
de UI e de backened são separadas
Tipicamente Interfaces de Serviço estáticas
Interface Open Client .NET
Conecta-se ao AppServer através de proxy
Passa Id da sessão e outros dados de
contexto
Pass parâmetros para a requisição
• Pode conter Datasets
Verifica segurança
Retorna resultados ao cliente
• Pode conter Datasets
Interface de Serviços UI .NET
public void GetCars
(string sessionid, string modelid,
out dsCarDataSet.eCarDataTable dtResult) {
Progress.Autoedge.StrongTypesNS.dsCarDataSet dsCars = null;
Progress.Autoedge.StrongTypesNS.dsContextDataSet dsContext =
new Progress.Autoedge.StrongTypesNS.dsContextDataSet();
Progress.Autoedge.StrongTypesNS.dsNullDataSet dsNull =
new Progress.Autoedge.StrongTypesNS.dsNullDataSet();
string status = string.Empty;
dsContext.ttContext.AddttContextRow(string.Empty,
"sessionID", sessionid);
dsContext.ttContext.AddttContextRow(string.Empty,
"wherestring", string.Empty);
Proxy.carfetchwhere(string.Empty, string.Empty,
ref dsContext, out dsCars, ref dsNull, out status);
if (dsCars.eCar.HasErrors == true)
Handle(dsCars.eCar.GetErrors());
if (dsCars.eCar.Rows.Count <= 0)
throw new InvalidOperationException();
dtResult = dsCars.eCar;
}
Cliente Web Services
Datasets
• Datasets não podem ser expostos a Web Services
• Before/After tables não são suportados em Web
Services
Tipicamente não há conhecimento sobre o cliente
• Não há informação de sessão/contexto de cliente
• Segurança limitada (e.g. não há login)
Cliente normalmente não tem conhecimento sobre
backend
• Precisa de serviços de granularidade fina, autodocumentados
Interface de Serviços Web Services
Conecta-se ao AppServer através do Web
Services Adapter
Passa informação de login
• Valida login
Passa informações de contexto/sessão
Parâmetros podem ter de ser mapeados em
Datasets
Datasets devem ser “quebrados” em temp-tables
A lógica de negócios é chamada Business logic
PROCEDURE fetchTestDrives :
/*-----------------------------------------------------------------------------Purpose:
Returns an XML list of Open TestDrives
Parameters: INPUT UserId
INPUT Password
OUTPUT Temp-Table for TestDrives
------------------------------------------------------------------------------*/
DEFINE INPUT PARAMETER pcUserName
DEFINE INPUT PARAMETER pcUserPassword
DEFINE OUTPUT PARAMETER TABLE FOR eTestDriveWS.
EMPTY TEMP-TABLE ttContext.
CREATE ttContext.
ASSIGN ttContext.ContextName = "UserLoginName":U
ttContext.ContextValue = pcUserName.
CREATE ttContext.
ASSIGN ttContext.ContextName = "UserLoginPass":U
ttContext.ContextValue = pcUserPassword.
RUN serviceinterface/proSIgui2.p
(INPUT "TestDriveWS":U,
INPUT "fetchOpen":U,
INPUT-OUTPUT DATASET dsContext BY-REFERENCE,
OUTPUT DATASET-HANDLE hDataset,
INPUT-OUTPUT DATASET dsNull BY-REFERENCE,
OUTPUT pcExcStatus ) .
END PROCEDURE.
public class autoedgeObj :
System.Web.Services.Protocols.SoapHttpClientProtocol {
[…]
public autoedgeObj() {
this.Url = "http://localhost/wsa/wsa1";
}
[…]
public string CreatePO_webservicesi() {
object[] results = this.Invoke("CreatePO_webservicesi",
new object[0]);
return ((string)(results[0]));
}
public System.IAsyncResult BeginCreatePO_webservicesi(
System.AsyncCallback callback, object asyncState) {
return this.BeginInvoke("CreatePO_webservicesi", new object[0],
callback, asyncState);
}
public string EndCreatePO_webservicesi(
System.IAsyncResult asyncResult) {
object[] results = this.EndInvoke(asyncResult);
return ((string)(results[0]));
}
}
Integração com Cliente Sonic
Dataset
• Datasets não podem ser enviados em mensagens
• Before/After tables não são suportadas
Tipicamente não há conhecimento sobre o cliente
Normalmente o cliente não tem conhecimento sobre
o backend
Deve ser apenas uma mensagem publicada
• Não há resposta direta
Integração com Cliente Sonic
Recebe a mensagem
Mensagem pode ter de ser mapeada em
Datasets
Passa informação de login
• Valida login
Passa informações de contexto/sessão
Chama-se a lógica de negócios
Interface de Serviços Sonic
Em suma…
Interfaces de serviço
• Conectam diferentes
tecnologias
• Implementam serviços
principais
• Devem ser criadas para cada
tipo de cliente
Perguntas?

Interfaces de Serviço na Prática

Transcrição

Documentos relacionados

RE/MAX Czech Republic

COMUNICADO DE IMPRENSA Os recursos naturais de África

Data Sheet

Durco® Mark 3™ ISO Bomba de Processamento Químico

OpenEdge - Plataforma

Realidade Virtual e Interfaces Modernas

PDF

empresa Binário

GILBARCO mpd

Luiz Agner

Resultado - Ceará

Gerenciamento e Replicação OpenEdge® – Divide et impera!

Usando ProDataSet™ no OpenEdge® 10