1)User对象
用户API要是通过User服务器租用类来实现其功能的,每个User类的对象代表着一个用户User对象是唯一的且可比较,若两个对象相同,则这两个对象代表着同一个用户。开发的应用程序可通过调用users.get_current_user()函数来访问当前用户的User对象,也可以利用电子邮件地址来构造User对象。
2)登录网址
用户API提供了函数来构建到Google账户的网址,这样Google账户允许用户登录或退出,并重新定向到用户的应用程序。登录或退出目标网址可以使用users.create_login_url()和users.create_logout_url()。
3)User类
User类的一个对象代表具有Google账户的—个用户users模块提供的。
(1)构造函数。class User(email=None)这个函数代表具有Google账户的用户函数中的电子邮件地址,默认为当前用户。若系统没有指定电子邮件地址,并且当前用户没有登录,那么系统将抛出UserNotFoundEiTOT错误。
系统在创建Use服务器租用对象时,不检査这个电子邮件地址是否有效。若该Use服务器租用对象的邮件地址不是有效的,则该User服务器租用对象仍然可能存储在数据库中,但是不会与真正的相匹配。
(2)实例方法。User实例主要提供以下方法。
(a)nickname():用来返回用户的“昵称”。
(b)email():用于返回用户的电子邮件地址。
(3)函数。google.appengine.api.users包主要提供以下函数。
(a)create_login_url(dest_url):用于返回一个网址。当用户访问这个网址时,它将提示用户使用自己的Google账户登录,并将用户重新定向到指定的dest_url网址。其中dest_url可以是完整的网址,也可以是相对于应用程序的域的路径。
(b)create_logout_url(dest_uri):用来返回一个网址。当用户访问这个网址时会注销这个用户,然后将用户重新定位到指定的dest_url网址。其中参数dest_url可以是完整的网址,或者是相对于应用程序的域的路径。
(c)get_current_user():若用户已登录,则该函数返回当前用户的user服务器租用对象;若用户未登录,返回None。
(4)异常。google.appengine.api.users包主要提供以下exception类。
(a)exception Error():这个包中所有异常的基类。
(b)exceptionUserNotFoundError():若用户没有提供电子邮件地址,且当前用户未登录,则系统将由User构造函数抛出异常。
(c)exception RedirectTooLongError():表示create_login_url()或create logout一url()函数的重定向网址的长度超过了所允许的最大长度。