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.