Definição de modelos de domínio

Core Data Services (CDS) são um conceito fundamental no CAP. Eles fornecem os meios para capturar de forma declarativa modelos de dados, bem como modelos de serviço.

Assista ao vídeo para compreender a abordagem baseada no modelo.

Nesta lição, vamos nos concentrar em modelos de domínio. Os modelos de serviço serão abordados na próxima lição.

Os modelos CDS são representados na notação de esquema central (CSN). CSN (pronunciado como "temporada") é semelhante ao esquema JSON, mas vai além dos recursos do JSON para capturar modelos entidade-relacionamento completos e extensões.

Assista ao vídeo para obter uma síntese dos formatos de origem e de destino dos modelos CDS.

Neste aprendizado, vamos definir modelos em arquivos .cds.

Como mencionado anteriormente, vamos agora analisar como criar modelos de domínio usando CDL. Para isso, criamos um arquivo com a extensão .cds na pasta db do projeto CAP. O nome do arquivo é arbitrário, um nome de arquivo comum é, por exemplo, schema.cds.

Primeiro, especificamos uma entidade de domínio único chamada Autores no arquivo (veja a figura Uma Entidade de Domínio Simples).

Entidades de domínio são tipos estruturados com elementos nomeados e tipificados que representam conjuntos de dados que podem ser lidos e manipulados usando operações CRUD usuais. Quando convertidas em modelos de persistência, as entidades se tornam tabelas.

Para digitar os elementos, o CDS vem com um pequeno conjunto de tipos integrados. Uma lista dos tipos integrados pode ser encontrada na documentação CDS.

A sintaxe entity Authors usada na figura é equivalente a define entity Authors. Isso significa que a palavra-chave define é opcional.

Utilize a palavra-chave key para indicar um ou mais elementos que formam a chave primária de uma entidade.

Você pode definir espaços de nomes que são aplicados automaticamente a todos os nomes relevantes em um arquivo. No exemplo exibido, o nome da entidade Autores tem como prefixo o espaço de nomes com.sap.learning, resultando em com.sap.learning.Authors como nome completo da entidade. Namespaces são apenas prefixos - não há nada de especial sobre eles além disso. Os espaços de nomes são opcionais - utilize-os se seus modelos puderem ser reutilizados em outros projetos; caso contrário, você pode fazer sem eles.

Na figura Exemplo de um tipo simples, um tipo simples chamado NoOfBooks é definido. Ele é baseado no tipo de dados integrado Integer. Isso significa que onde NoOfBooks é usado, ele representa essencialmente um valor Integer .

A entidade Livros exibida tem um elemento de estoque digitado com o tipo NoOfBooks . Isso significa que o tipo de dados desse elemento é essencialmente Integer.

A definição

1
type NoOfBooks : Integer;

1
define type NoOfBooks : Integer;

Tipos estruturados são tipos de dados personalizados que combinam um ou mais elementos relacionados em um único tipo. Eles permitem criar estruturas de dados complexas e utilizá-las em entidades.

A entidade Livros mostrada na figura Exemplo de um tipo estruturado tem um elemento de preço do tipo Price, que é um tipo estruturado definido separadamente.

O tipo Price tem dois elementos: montante do tipo integrado Decimal e moeda do tipo integrado String com um comprimento máximo de 3 caracteres.

Enumerações (ou enumerações para abreviar) podem ser usadas para tornar o código mais legível e auto-explicativo, uma vez que permitem que você substitua valores crípticos por símbolos na lógica de aplicação.

Você pode indicar valores de enumeração para um tipo como uma lista separada por ponto-e-vírgula de símbolos com valores correspondentes atribuídos. Para tipos de cadeia, a atribuição de valores reais é opcional; se omitidos, os valores reais são os equivalentes de cadeia dos símbolos.

A entidade Books na figura Exemplo de enumeração tem um elemento chamado gênero do tipo Genre, que é um tipo personalizado com valores de enumeração.

O tipo Genre é baseado no tipo Integer integrado, o que significa que cada símbolo na enumeração corresponde a um valor Integer .

A enumeração Genre contém dois símbolos: ficção, que corresponde a Integer valor 1, e não-ficção, que corresponde a Integer valor 2.

Quando você executa cds watch no terminal para iniciar um servidor, seu Domain Model, que é definido na pasta db do projeto, é automaticamente convertido em um modelo de persistência e implementado no banco de dados configurado. Isso significa que as instruções DDL SQL correspondentes são geradas e executadas com base em seu modelo CDS.

Você também pode gerar essas instruções DDL SQL manualmente usando o seguinte comando no terminal:

1
cds compile <models> [<options>]

1
cds compile ?

Para gerar um script SQL DDL para um Domain Model contido em um arquivo chamado schema.cds na pasta db do projeto CAP, execute este comando no diretório raiz do projeto:

1
cds compile db/schema.cds --to sql

O script DDL SQL na figura Modelo CDS compilado foi gerado dessa forma.

Assista ao vídeo para compreender as regras que se aplicam à saída DDL SQL gerada.

Mais tarde, veremos que as entidades projetadas são geradas como visões. Veremos também que os campos de chave externa são criados automaticamente nas tabelas de banco de dados geradas para refletir determinadas associações que podem ser definidas entre entidades.

Assista ao vídeo para ver como capturar um modelo de domínio.