Home > Guides > Contributors Guide > Requirements |

Apache Struts 2 Documentation
Requirements
Edit Page Browse Space Add Page Add News

Under Construction

## Struts 2: A Plausible Requirements Document

The outline for this document is adapted from Writing Effective Use Cases, pages 13-14.

### Chapter 1. Purpose and Scope

1a. | What is the overall scope and goal? What is our mission statement?
1b. | Who are the Stakeholders? (Who cares if we build the system or not?)
1c. | What topics are within our scope? What topics are out of scope?

### Chapter 2. Terms Used / Glossary

### Chapter 3. The Use Cases

3a. | The primary actors and their general goals
3b. | The business use cases (operations concepts)
3c. | The development use cases (developer concepts)
3d. | The framework use cases (system concepts)

### Chapter 4. The Technology Used

4a. | What technology requirements are there for this system?
4b. | With what systems will this system interface? What are the interface requirements?

### Chapter 5. Other requirements

5a. | Development process
| Q1. Who are the project participants?
| Q2. What values will be reflected? (Simple, soon, fast, or flexible?)
| Q3. What feedback or project visibility do the users and sponsors expect?
| Q4. What can we import? What must we build? What other systems have a similar scope?
| Q5. Under what other process requirements does the project operate?
5b. | Business Rules
5c. | Performance
5d. | Operations, security, documentation
5e. | Use and usability
5f. | Maintenance and portability
5g. | Unresolved or deferred

#### Mission

What is the overall scope and goal? What is our mission statement?

Scope | MVC framework for professional web application developers and development teams.
Goal | Encourage developers to use a supplied set of base classes and tag libraries (thereby avoiding a potential tangle mess of pages).
Mission Statement | Create the web framework that we want to use to build our own applications: a MVC framework that balances flexibility with uniformity.

#### Stakeholders

Who are the Stakeholders? (Who cares if we build the system or not?)

Stakeholder | Rationale
--- | ---
Apache Software Foundation | ...
Apache Struts PMC |
Other Struts Committers |
Other Struts contributors |
Other Users and teams |
Container, Extension, and IDE makers |
Information Technology Managers |
Government contractors |
Other MVC frameworks |
Web platform vendors (Sun) |

#### Topics

In/Out of Scope | Topic
--- | ---
| Utilizing HTTP and HTML implementations
| Implementing or extending HTTP and HTML specifications
| Naming the framework something else
| ...

#### Glossary

- MVC - ...
- HTTP
- HTML
- Front Controller
- Dispatcher
- request
- response
- Page Controller
- container
- Dependency Injection
- Inversion of Control
- domain object
- URL pattern
- resource
- singletons

#### Technology

What technology requirements are there for this system?

- Java 5
- Servlet API 2.4
- JSP API 2.0
- HTTP 1.0
- HTML 4.01 / XHTML 1.0
- JavaScript/ECMAScript ECMA-262

#### Systems

With what systems will this system interface? What are the interface requirements?

- Popular web browsers utilizing HTTP / HTML
- JavaScript
- JavaScript AJAX libraries
- Data access libraries utilizing singletons or Dependency Injection
- Web application resources (server pages, servlets) utilizing Servlet API
- Java compilers and code formattings utilizing the source code
- Unit testing lbiraries utilizing the Java and Servlet APIs
- Electronic mail systems utilizing SMTP, POP3, or IMAP, usually via JavaMail
- ...

#### Process

Development process

##### Who are the project participants?

The Apache Struts PMC and other Struts committers, along with other volunteer contributors.

##### What values will be reflected? (Simple, soon, fast, or flexible?)

Simple and flexible.

##### What feedback or project visibility do the users and sponsors expect?

The project is expected to be transparent. All development decisions are expected to take place on the public mailing list. The private PMC list is only to be used when discussing individuals (new committers) and a rapid response to a new security issue.

##### What can we import? What must we build? What other systems have a similar scope?

Import

- Various Jakarta Commons and Open Symphony packages, including XWork
- Other packages under a compatible license

Build

- Web Compatibility layer over XWork
- UI tags that utilize framework resources

##### Under what other process requirements does the project operate?

The ASF Bylaws, other relevant resolutions of the ASF Board, and the Apache Struts Project Charter (in that order). See also How the ASF works.

#### Business Rules

...

#### Performance

...

#### Operations, security, documentation

...

#### Use and usability

...

#### Maintenance and portability

...

#### Unresolved or deferred

...

Children Show Children Hide Children
$page.link($child) (Apache Struts 2 Documentation)