社区
企业信息化
帖子详情
请问编写各种软件文档的目的是什么?(急)
fivehun2001
2004-07-30 10:20:37
比如:概要设计说明书、详细设计说明书等等。哪里有这样的文章?
...全文
1702
5
打赏
收藏
请问编写各种软件文档的目的是什么?(急)
比如:概要设计说明书、详细设计说明书等等。哪里有这样的文章?
复制链接
扫一扫
分享
转发到动态
举报
写回复
配置赞助广告
用AI写文章
5 条
回复
切换为时间正序
请发表友善的回复…
发表回复
打赏红包
52juanjuan
2004-07-30
打赏
举报
回复
编写文档的主要目的是便于管理,有利于对软件的可控性。把握软件的进度,风险等。各种不同的软件文档起着软件生命周期中不同的作用。详细情况可以参考软件工程中的详细介绍即可。
tstony987
2004-07-30
打赏
举报
回复
文档模板中有的给出一些该文档的编写目的。
可以参考一些软件工程方面的资料
yeeshengwei
2004-07-30
打赏
举报
回复
便于程序的使用管理维护以及后续开发
Fusuli
2004-07-30
打赏
举报
回复
目的是管理和交流,还有缓解领导对项目不可控制性的恐惧心理
有时候还是为了满足客户
Guhai
2004-07-30
打赏
举报
回复
编写文档的主要目的在于规范化软件的生产,给软件的设计,编码,测试,维护等提供依据。
Maven2 的新特性.7z
Maven2 的新特性.7z
文档
选项 打印本页 将此页作为电子邮件发送 级别: 初级 键 胡 (jianhgreat@hotmail.com), 西安交通大学硕士 伟红 胡 (huweih@cn.ibm.com), 工程师,IBM 区域合作伙伴支持中心, IBM 2006 年 2 月 23 日 本文主要阐述 Maven2 的新特性,这些新特性可以大大地缩短了开发管理中的工作量,使得开发人员将精力集中在实际的业务问题上。 Maven 出现到现在也有很长时间了,初识它的感觉至今仍清晰的印在脑海中。现在想来,当时从 Ant 移情 Maven 的想法其实很朴素,就是因为 Maven 可以以网站的形式展现与项目相关的信息,如开发人员列表、各种 Report。这种方式为项
目的
构建带来了极大的方便,尤其是 Report 的。试想对于产生的 Junit-Report、JavaDoc、CheckStyle、PMD 等报告,如果没有一个统一的入口,每次切换目录是多么令人厌烦的事情! Maven 无疑是相当成功的,这一点从越来越多的开源项目开始使用 Maven 就可以看出。Maven 取得成功的原因很简单:在简化构建脚本的同时,功能并没有缩水,反而有所增强;提供汇集项目信息的工具,并以相当友好的方式呈现;丰富的插件简化了工作。如此有力的工具出现,自然是争相使用。 新特性 如今 Maven2 已经推出,Maven 的官方网站称,Maven2 相对于 Maven1 是一个相当大的转变,甚至不惜牺牲兼容性来达到这一
目的
。(为了 Maven1 的用户着想,Maven1 仍在继续他的使命。)如此大的变动到底换来了什么样的结果? 1. 更快、更简单 比起 Maven1 那不
急
不慢的运行速度,Maven2在速度上有了质的飞跃,甚至与Ant相比也毫不逊色(当然,下载不算)。除此之外,"简化工作,使用业界公认的最佳实践"也是是 Maven2 的另一大主题,其他的新特性无处不在体现 Maven2 为简化工作而做出的努力。 2. 更少的配置文件 Maven1 和 Maven2 主要配置文件的对比: • Maven1:project.xml、maven.xml、project.properties和build.properties。 • Maven2:pom.xml和settings.xml。 POM是Maven的核心对象模型,在Maven2中POM已由project.xml转移到pom.xml中使用,版本也由3升级为4。对于项目,一般只需要pom.xml就行了。 在Maven2中不需要也不提倡使用maven.xml,原因如下: • plugin的易用性的增强。 • 散布于maven.xml中的内容难以在不同项目间共享,也不利于维护。在Maven2中建议使用自定义的plugin来封装这些内容。 如果仍期望能够使用类似maven.xml的功能,如
,请参考Inserting non-standard build steps using preGoals and postGoals。 在Maven2中,配置使用settings.xml,它取代了原有的project.properties和build.properties。配置在Maven2中存在两种级别: • 用户级,针对操作系统登录用户而言。一般在$home/.m2/,对于windows用户,就是目录:C:\Documents and Settings\用户名\.m2\settings.xml。 • 全局级:一般在%M2_HOME%/conf/settings.xml,M2_HOME是Maven2的根目录环境变量名。 在settings.xml中可以配置,如本地Repository、proxy等等,关于settings.xml的结构可以从Maven的官方网站上获取。 3. Plugin语言更换 在Maven2中,
编写
plugin的语言由jelly变更为Java和BeanShell。Java在速度上更有优势,而且开发人员的熟悉程度更高。对于其他的流行脚本,如groovy,Maven的官方网站的意见是,等待其更成熟时再考虑 。 4. 提供预定义的目录模板 好的目录结构可以使开发人员更容易理解项目,为以后的维护工作也打下良好的基础。Maven2根据业界公认的最佳目录结构,为开发者提供了缺省的标准目录模板。Maven2的标准目录结构如下: 使用目录模板,可以使pom.xml更简洁。因为Maven2已经根据缺省目录,预定义了相关的动作,而无需人工的干预。以resources目录为例: • src/main/resources,负责管理项目主体的资源。在使用Maven2执行compile之后,这个目录中的所有文件及子目录,会复制到target/classes目录中,为以后的打包提供了方便。 • src/test/resources,负责管理项目测试的资源。在使用Maven2执行test-compile之后,这个目录中的所有文件及子目录,会复制到target/test-classes目录中,为后续的测试做好了准备。 这些动作在 Maven1 中,是需要在 maven.xml 中使用
或
来完成的。如今,完全不需要在pom.xml中指定就能够自动完成。在src和test都使用resources,方便构建和测试,这种方式本就已是前人的经验。通过使用Maven2,使这个经验在开发团队中得到普及。 创建标准目录模板,可以通过如下命令: mvn archetype:create -DgroupId=com.codeline.commons -DartifactId=codelineCommons groupId和artifactId的含义与Maven1中的含义一样,参数artifactId的值会作为项目根目录的名字。除了建立相应的目录之外,Maven2还会创建缺省的pom.xml。 Maven2也考虑到:不同类型的项目需要拥有不同的目录结构。如创建web项目,可以使用命令: mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-webapp -DarchetypeArtifactId=maven-archetype-webapp 5. 生命周期的引入 在Maven2中有了明确的生命周期概念,而且都提供与之对应的命令,使得项目构建更加清晰明了。主要的生命周期阶段: • validate,验证工程是否正确,所有需要的资源是否可用。 • compile,编译项
目的
源代码。 • test-compile,编译项目测试代码。 • test,使用已编译的测试代码,测试已编译的源代码。 • package,已发布的格式,如jar,将已编译的源代码打包。 • integration-test,在集成测试可以运行的环境中处理和发布包。 • verify,运行任何检查,验证包是否有效且达到质量标准。 • install,把包安装在本地的repository中,可以被其他工程作为依赖来使用 • deploy,在整合或者发布环境下执行,将最终版本的包拷贝到远程的repository,使得其他的开发者或者工程可以共享。 • generate-sources,产生应用需要的任何额外的源代码,如xdoclet。 如果要执行项目编译,那么直接输入:mvn compile即可,对于其他的阶段可以类推。阶段之间是存在依赖关系(dependency)的,如test依赖test-compile。在执行mvn test时,会先运行mvn test-compile,然后才是mvn test。 6. 新增Dependency Scope 在POM 4中,
中还引入了
,它主要管理依赖的部署。目前
可以使用5个值: • compile,缺省值,适用于所有阶段,会随着项目一起发布。 • provided,类似compile,期望JDK、容器或使用者会提供这个依赖。如servlet.jar。 • runtime,只在运行时使用,如JDBC驱动,适用运行和测试阶段。 • test,只在测试时使用,用于编译和运行测试代码。不会随项目发布。 • system,类似provided,需要显式提供包含依赖的jar,Maven不会在Repository中查找它。
的使用举例:
hibernate
hibernate
3.0.3
test
7. 传递依赖,简化依赖管理 在Maven1中,需要把依赖所需要的包也一并列出。这对于使用类似如Hibernate的用户来说所操的心太多了,而且也不方便。在Maven2中实现了传递依赖,如此对于Hibernate所依赖的包,Maven2会自动下载,开发人员只需关心Hibernate即可。 注意:只有得到Maven支持的依赖,通常是plugin形式出现,才能获得这个特性。而且对于一些老的plugin,可能由于时间的关系不支持传递依赖。如至少在Maven 2.0.1中,对于Hibernate 2.1.2,仍然需要显式列出Hibernate 2.1.2所依赖的包。 回页首 使用简介 安装Maven2的步骤非常简单:首先从Maven官方网站下载相应的
软件
包,目前是Maven 2.0.1;然后解压,并设置环境变量M2_HOME= Maven2的解压安装目录;最后将%M2_HOME%/bin添加到path中,方便Maven在任何目录下运行。 Maven2的运行命令是mvn,使用mvn -h可以获得相关的帮助信息。常用情形: • 创建Maven项目:mvn archetype:create • 编译源代码:mvn compile • 编译测试代码:mvn test-compile • 运行测试:mvn test • 产生site:mvn site • 打包:mvn package • 在本地Repository中安装jar:mvn install • 清除产生的项目:mvn clean 或许是由于刚刚推出的缘故,Maven2目前还是有一些不尽如人意的地方。尤其是Report部分的plugin,有的是因为目前还没有,如junit-report。有的则是一些莫名其妙的问题,如checktyle和pmd,在本地locale下都无法正常工作。以pmd举例,在产生PMD报告时会抛出如下异常: java.util.MissingResourceException: Can't find bundle for base name pmd-report, locale zh_CN at java.util.ResourceBundle.throwMissingResourceException(ResourceBundle .java:839) at java.util.ResourceBundle.getBundleImpl(ResourceBundle.java:808) at java.util.ResourceBundle.getBundle(ResourceBundle.java:702) …… 幸运的是,Maven2一出现就备受关注,要不了多长时间,诸如此类的问题应该就会很快解决。 回页首 结论 Maven2在Maven1的优势基础之上,又向前迈进了一大步。它提供的这些新特性大大地缩短了开发管理中的工作量,使得开发人员将精力集中在实际的业务问题上。而且这些新特性对于简化使用,普及最佳实践,也起到了积极的作用。 参考资料 • Inserting non-standard build steps using preGoals and postGoals http://docs.codehaus.org/display/MAVEN/Maven2+Goal+Decoration • Maven官方网站 http://maven.apache.org/ • Maven支持的依赖列表 http://www.ibiblio.org/maven2 • 在 Eclipse 中利用 Maven • 项目管理: Maven 让事情变得简单 作者简介 胡键,西安交通大学硕士,2000年毕业后一直从事
软件
开发。2002年开始使用Java,在平时的项目开发中经常采用OpenSource的工具,如Ant、Maven、Hibernate、Struts等,目前正在研究信息集成方面的规范和技术。可以通过jianhgreat@hotmail.com与他取得联系,或访问个人blog:http://blog.donews.com/foxgem/。 胡伟红,西安交通大学硕士,目前就职于IBM 区域合作伙伴支持中心。主要负责Websphere产品的支持。对开源的项目有很大的兴趣。可通过 huweih@cn.ibm.com 与她联系。
软件
测试工程师的职责是什么?
软件
测试工程师(Software Testing Engineer)指理解产品的功能要求,并对其进行测试,检查
软件
有没有错误(Bug),测试
软件
是否具有稳定性(Robustness),写出相应的测试规范和测试用例的专门工作人员。简而言之,
软件
测试工程师在一家
软件
企业中担当的是“质量管理”角色,及时发现
软件
问题并及时督促更正,确保产品的正常运作。按其级别和职位的不同,分为三类。2、
用word
编写
格式统一的项目
文档
1、本课程是《成为项目经理的方法》的后续课程,主要是给项目经理提供一种解决项目组内部word
文档
风格各异,调整格式需要花很多时间的问题的方法。2、本课程从最简单的会议纪要、周报开始,到项目过程
文档
模板的制作及使用,详细讲解了制作格式统一的项目
文档
的方法。 Normal 0 7.8 磅 0 2 false false false EN-US ZH-CN X-NONE /* Style Definitions */ table.MsoNormalTable 3、本课程赠送课内制作的所有模板,以及有监理的外部客户项目,验收时需要提交的
文档
模板及内部管理用
文档
的模板。
重视
文档
管理提升
软件
测试水平
窗外,酷热的夏日正散发着让人心烦的热量,热浪迫人的空气使人感到非常不舒服。最近,我接手一个测试到一半的
软件
测试项目,接手这个项目时只有只言片语的几份简单测试
文档
,没有详细的测试计划,更没有详细的测试记录。此项目让我深深感受到没有测试
文档
的痛苦,所有的一切都要自己重新摸索。这里说一下我对测试
文档
的体会。
什么是测试
文档
?
当我从前任测试同事手中接过“薄薄两页纸”的测试
文档
时,我难以置信的看着他问“没有了吗?只有这些?”。同事尴尬的点点头,又
图书管理系统需求规格说明
文档
目录_
软件
需求分析教与学(教学大纲)
需求分析课程教学大纲01.课程说明课程名称需求分析总学时32先修课程:
软件
工程导论、数据库原理与设计、信息系统基础02.课程性质、
目的
和任务
软件
开发一般包括可行性分析、需求分析、
软件
设计、
软件
开发、
软件
测试、
软件
实施、
软件
服务等步骤。需求分析是
软件
开发的一个步骤,主要作用是充当
软件
研发与客户之间的桥梁,包括对客户的信息化需求进行分析,将客户不规范的、随意的需求,转换成规范的、严谨的、结构...
企业信息化
1,759
社区成员
5,874
社区内容
发帖
与我相关
我的任务
企业信息化
企业开发 企业信息化
复制链接
扫一扫
分享
社区描述
企业开发 企业信息化
社区管理员
加入社区
获取链接或二维码
近7日
近30日
至今
加载中
查看更多榜单
社区公告
暂无公告
试试用AI创作助手写篇文章吧
+ 用AI写文章