SQL Server 存储过程,并创建可返回到用户界面进行显示的消息(或消息集合)。
例如,下面是一个数据访问组件的一部分示例代码,该组件将从数据存储中检索单个 Topic 记录,并将正确的消息格式返回到用户界面。
Public Function GetTopicRecord(ByVal ID As Integer) As Messages.Topic
Dim t As Messages.Topic = New Messages.Topic
cn = New SqlConnection(secureConnectionString)
cd = New SqlCommand("GetTopic", cn)
cd.CommandType = CommandType.StoredProcedure
cd.Parameters.Add("@ID", ID)
cn.Open()
dr = cd.ExecuteReader()
dr.Read()
With t
.ID = ID
.Title = dr("Title")
.Description = dr("Description")
End With
Return t
End Function
设计文档将包括一系列用于处理来自用户界面的各个请求的类和方法,并含有有关调用哪个存储过程以及返回何种消息格式的详细信息。同样,我们将在后面主要介绍数据访问图层的文章中讨论此过程的细节。
Web 用户界面
最后,用户界面设计文档将包括完成各种方案所需的所有用户输入和显示。通常来说,用户界面文档包括界面机制的细节以及使用户界面呈现唯一性的图形设计元素。例如,配色方案、字体和总体页面设计,与用于获取搜索查询的正确数据的输入名称和输入数量一样重要。
要使文档简洁,通常在一个与图形设计单独的文档中概要描述机制细节。这是我们将要在示例中做的工作。在后面的一篇文章中,我们将创建一个综合性用户界面文档和实现方案,详细说明每个屏幕的元素和相关操作。在另一篇文章中,我们将处理应用程序有关图形的各个方面,重点讨论作为一种外观服务的级联样式表的使用。
下面是一个典型的用户界面描述,它涉及“主题”编辑方案。
主题输入屏幕
“主题”屏幕将显示所有当前主题(主题 ID 和主题名称)的一个缩略列表,在每个主题旁边还将显示一个“编辑”链接。单击“编辑”链接将会调用关联的主题记录并将其显示在一系列的输入框中。“标题”和“描述”是可编辑的,而“主题 ID”是只读的。用户可以编辑标题和描述,然后按“保存”按钮将更改写入数据存储。输入将被验证。两者都是必需的输入项,“标题”的长度限制为 30 个字符,“描述”的长度限制为 500 个字符。更新完成后,将显示一条响应消息指出已确认更新;如果更新失败,则显示一条消息指出错误状况。
用户还可以删除现有的主题记录,方法是单击列表中的“编辑”链接,审核显示屏幕上的记录细节后,单击“删除”链接。删除完成后,将显示一条响应消息指出已确认更新;如果更新失败,则显示一条消息指出错误状况。请注意,用户不能删除与现有问题或回答相关联的主题。
此外,用户可以完整地添加新主题记录,方法是在初始显示屏幕上单击“新建主题”链接。将显示“标题”和“描述”输入(不显示 ID 输入)并提供一个“保存”按钮。输入将被验证。两者都是必需的输入项,“标题”的长度限制为 30 个字符,“描述”的长度限制为 500 个字符。更新完成后,将显示一条响应消息指出已确认更新;如果更新失败,则显示一条消息指出错误状况。
利用上面的叙述,您可以轻松地实现一个完整的功能屏幕。判断一个好的设计文档的方法是:它能够使读者完成工作,且不会提出额外的问题。最终的用户界面设计文档将包括应用程序中每个屏幕的此类叙述。
小结并付诸行动
我们简要介绍了数据库、中间层和用户界面实现方案的最终设计文档。加上体系结构和初始规划文档,它们形成了我们的完整设计包。在