Now it's time for you to add the functionality
to save entities to your app. Let's see how you
can achieve that. Okay. So here I'm looking at the
saveProfile method in the ConferenceAPI class. If you recall, we
already have the code to create a new profile.
We just call new on the profile, and pass in
the arguments that we need. Creating a new profile entity
is as simple as calling new on the profile class.
If we weren't using objectify, the code would be
more complicated. You already have the code to create a
new profile object, but you don't need to make
any changes now that the profile has been identified as
an entity. However, creating an entity doesn't automatically save
it in the data store. You have to explicitly save
it if you want it saved. Okay, I'm going to
go ahead and add the code to save the profile
entity in the data store. You're going to be writing
this code yourself in your own app in just
a minute. Now, I'll run the app again on
local host, and go to the APIs Explorer. So
here I am in the APIs Explorer and I'm
going to go into the Save Profile method again.
And, execute it. And have Lemon Cake as my
display name. Set my TeeShirtSize to M, and execute it.
Oops, I forgot to authorize. Let's try that again because that's not authorized.
Authorize. Now I can execute the function again, I
don't need to enter the values, just press Execute.
And there it goes. It's creating my profile. And
you see here, the request set the display name
to Lemon Cake, T shirt size to medium to
M. Response returned profile with these fields. So the
response shows that the profile was created. But this
time, hopefully it was more than created, it was actually
saved in the data store. And we can use the data store admin to check that. So
now I'm going to go to the admin console on local host. To get to the admin
console, you go to the port where your app is running, which is for me that's
localhost:8080. And then it's
/_ah/admin and this takes us to the Datastore view. The
Datastore admin for local host opens. You can see here
that it doesn't know what my app ID is. Says your
app ID, and that's okay, because local host doesn't care what
the app ID is. Course when I when actually want to
deploy to appspot I will need to provide a real app
ID. The admin console opens by default showing the Datastore Viewer.
But if you're somewhere else and you want to get back
to the Datastore Viewer, or for some reason it doesn't open
there by default, you just click this Datastore Viewer and there you are in the
Datastore Viewer. This entity kind menu shows the
different kinds of entities that are stored in
your Datastore. Right now, the only one
we've got is Profile. You'll click List Entities,
to seal the entities of that kind that
have already been saved. There'll probably be only
one entity now, which is the profile that
we just saved. So the data store viewer shows
you the entities, it shows you the properties. We've
got displayName, mainEmail, teeShirtSize. Okay, so that was just
a quick review of how to save the entity in the data store, and how to go to
the admin console on local host to look at
your entities. You're going to be doing that now.
Ahora es el momento
de agregar funcionalidad
para guardar entidades para tu app.
Veamos cómo se puede lograr eso.
Bueno. Aquí estoy mirando
el método saveProfile
en la clase ConferenceAPI.
Si recuerdas, ya tenemos el código
para crear un nuevo perfil.
Llamamos a new en el perfil,
y pasamos los argumentos que necesitamos.
Crear una nueva entidad perfil
es tan simple como llamar a new
en la clase profile.
Si no estuviéramos usando Objectify,
el código sería más complicado.
Ya tienes el código
para crear un nuevo objeto perfil,
pero no necesitas realizar ningún cambio
ahora que el perfil
ha sido identificado como una entidad.
Sin embargo, al crear una entidad
no se guarda automáticamente
en el almacén de datos.
Tienes que guardarla explícitamente
si la quieres guardar.
Bien, voy a seguir adelante
y añadir el código para guardar
la entidad perfil en el almacén de datos.
Vas a escribir este código tú mismo
en tu propia app en un minuto.
Ahora, voy a ejecutar la app
de nuevo en el localhost,
e iré al Explorador de API.
Así que aquí estoy en el Explorador de API
y entro en el método saveProfile de nuevo.
Y lo ejecuto.
Y tengo Lemon Cake
como mi nombre para mostrar.
Fijo mi TeeShirtSize a M, y lo ejecuto.
Uy, me olvidé de autorizar.
Probemos de nuevo
porque no está autorizado.
Autorizo.
Ahora puedo ejecutar la función de nuevo,
no necesito introducir los valores,
solo pulso Ejecute.
Y ahí va.
Se está creando mi perfil.
Y aquí ves, la petición
fijó el nombre para mostrar a Lemon Cake,
la talla de la camiseta a medio, a M.
La respuesta retornó el perfil
con estos campos.
Entonces la respuesta
muestra que el perfil fue creado.
Pero esta vez, hizo más que crearlo,
fue guardado en el almacén de datos.
Podemos usar el admin del almacén de datos
para verificarlo.
Entonces voy a la consola de admin
en el localhost.
Para llegar a la consola de admin,
vas al puerto donde se ejecuta tu app,
el cual es para mí localhost:8080.
Y entonces es /_ah/admin
y esto nos lleva al Datastore Viewer.
El admin del Datastore
para el localhost se abre.
Puedes ver aquí que no sabe
cuál es el ID de mi app.
Dice your-app-id, y está bien,
porque al localhost no le importa
cuál es el ID de app.
Por supuesto
cuando haga el deploy en AppSpot
tendré que dar una ID de app real.
La consola de admin se abre por defecto
mostrando el Visor del Datastore.
Pero si estás en otro lugar
y deseas volver al Visor del Datastore,
o por alguna razón
no se abre allí por defecto,
simplemente haces clic en Datastore Viewer
y ya estás en el Visor del Datastore.
Este menú de tipo entidad
muestra los diferentes tipos de entidades
que se almacenan en tu Datastore.
En este momento,
el único que tenemos es Profile.
Haces clic en List Entities,
para ver las entidades de ese tipo
que ya se han guardado.
Probablemente solo habrá una entidad,
que es el perfil que acabamos de guardar.
Entonces el visor del almacén de datos
te muestra las entidades,
te muestra las propiedades.
Tenemos displayName,
mainEmail, teeShirtSize.
Bien, esto solo fue una revisión rápida
de cómo salvar la entidad
en el almacén de datos,
y cómo ir a la consola de admin
en el localhost para ver tus entidades.
Vas a hacer eso ahora.
ではエンティティをアプリに保存するために
機能性を追加します やり方を見ていきましょう
ConferenceApiのクラスの
saveProfileメソッドを見てください
new Profileを作成するコードはすでにあるので
Profileの上にnewを呼び出し
必要な引数を渡します
new Profileエンティティの作成は
Profileのクラスに
newを呼び出すのと同じくらい単純です
もしObjectifyを使っていなければ複雑でした
すでにnew Profileオブジェクトを
作成するコードがあり
エンティティとして認識されているので
変更する必要はありません
でもエンティティを作成しただけでは
保存はできません
保存するためのコードが必要です
ではProfileエンティティを
保存するためのコードを追加します
皆さんにはこのあとやってもらいます
このアプリをローカルホストで再び起動し
APIs Explorerを開きます
起動したら再びsaveProfileメソッドへ進み
実行します
displayNameをLemon Cake
teeShirtSizeをMに設定して実行します
認証を忘れていました 再度実行しましょう
認証 そして実行します
値を入れる必要はなくExecuteをクリックします
今profileが作成されています
RequestはdisplayNameをLemon Cake
teeShirtSizeをミディアムのMと設定しています
Responseはこれらのフィールドで
profileを戻しました
Responseはprofileが作成されたことを
示していますが
ここでは作成されただけではありません
Datastoreに保存もされました
Datastore adminで確認してみましょう
ローカルホストの管理コンソールへ進みます
まずはアプリが起動しているポートへ進みます
ポートはlocalhost:8080です
そして/_ah/adminと入れると
Datastore Viewerに進み
ローカルホストのDatastore adminが開きます
私のapp IDが分かっていませんので
your-app-idとなっています
ローカルホストではアプリIDは関係ないので
これで大丈夫です
appspotにデプロイしたい場合は
app IDが必要になります
管理コンソールは
Datastore Viewerを示すデフォルトで開きます
もし別の場所から
Datastore Viewerに戻りたい場合や
またはデフォルトで開かなかった場合は
Datastore Viewerをクリックします
このEntity KindのメニューはDatastoreに
保存されているエンティティを表示します
ここで保存されているのはProfileだけですね
List Entitiesをクリックして
すでに保存してあるエンティティは閉じてください
今は私たちが保存した1つのProfileだけですね
Datastore Viewerはエンティティと
プロパティを表示します
displayName、mainEmail、teeShirtSizeとあります
ここではエンティティを
Datastoreに保存する方法と
管理コンソールへの進み方を見てきました
では皆さんの番です
Agora é o momento de adicionar a função
de salvar entidades em seu aplicativo.
Vejamos como fazer isso.
OK, aqui estamos, olhando o método
saveProfile na classe ConferenceAPI.
Se você se lembra, já temos o código
para criar um novo perfil.
Apenas chamamos "Novo" no perfil
e passamos os argumentos
de que precisamos.
Criar uma nova entidade de perfil
é tão simples quanto chamar "Novo"
na classe de perfil.
Se não usássemos a objetificação,
o código seria mais complicado.
Você já tem o código para criar
um novo objeto de perfil
mas não precisa fazer mudanças agora que
o perfil foi identificado como entidade.
Porém, criar uma entidade não a salva
automaticamente no repositório de dados.
Você precisa dizer explicitamente
para salvar, se quiser salvar.
OK, vou adiante e adiciono o código
para salvar a entidade de perfil
no repositório de dados.
Você mesmo vai escrever
esse código no seu aplicativo
em menos de um minuto.
Agora, vou executar o aplicativo
novamente no localhost
e vou ao Explorer do API.
Aqui estou, no Explorer do API
e vou novamente para
o método saveProfile.
E executo.
E tenho Bolo de Limão
como meu nome de exibição.
Defino meu tamanho de camiseta
em M, e executo.
Ops, esqueci de autorizar. Vamos
tentar de novo porque não foi autorizado.
Autorizar. Agora, posso
executar a função de novo.
Não preciso inserir os valores,
apenas apertar Executar.
E lá vai.
Está criando o meu perfil.
Veja aqui, a solicitação definiu
o nome de exibição como Bolo de Limão
o tamanho da camiseta
como médio, como M.
A resposta retornou o perfil
com esses campos.
A resposta mostra que o perfil foi criado.
Mas, desta vez, esperamos que,
mais do que criado
que tenha sido de fato
salvo no repositório.
Podemos usar o administrador do
repositório para checar isso.
Vou ao painel de administração
no localhost.
Para chegar ao painel de administração
vá à porta em que seu aplicativo
está rodando, que, aqui, é localhost:8080
e, então, é /‗ah/admin
e isso nos leva ao Visualizador
do Repositório de Dados.
Abre o painel de administrador do
repositório de dados para localhost.
Você pode ver aqui que ele não sabe
qual a minha ID de aplicativo.
Diz your-app-id, mas tudo bem
porque o localhost não se importa
com a ID do aplicativo.
É claro que, quando for
implantar no AppSpot
vou precisar de uma
verdadeira ID de aplicativo.
O painel de administração geralmente abre
exibindo o Visualizador
do Repositório de Dados.
Mas se estiver em algum outro lugar
e quiser voltar ao Visualizador
ou se, por acaso,
não abrir diretamente lá
basta clicar aqui em Datastore Viewer
e isso leva ao Visualizador.
Esse menu por tipo de entidade
mostra os diferentes tipos de entidades
que estão armazenadas no seu repositório.
Neste momento, a única que temos é Perfil.
Clique "Listar Entidades" para ver todas as
entidades desse tipo que já foram salvas.
Haverá apenas uma entidade agora,
que é o perfil acabamos de salvar.
O Visualizador mostra a você
as entidades e propriedades.
Temos displayName,
mainEmail, teeShirtSize.
Essa foi apenas uma rápida recapitulação
de como salvar a entidade no repositório
e como ir ao painel de administração
no localhost para ver as entidades.
Agora é sua vez de fazer isso.