Tanager

Sequence Diagram Specification

 

Version 3.11 – Elaboration Phase 3


Revision History

Date

Version

Description

Author

15 Aug, 2006

1.0 – Elaboration Phase 1

Initial Revision.  Added Power On main success scenario diagram.

Bob Lavey

14 Sep, 2006

1.1 – Elaboration Phase 1

Added Power Off main success scenario diagram.

Bob Lavey

17 Oct, 2006

1.2 – Elaboration Phase 2

Added Download a Song main success scenario

Bob Lavey

03 Dec, 2006

2.0 – Elaboration Phase 2

Added Play Music and Pause Music scenario diagrams

Bob Lavey

22 Dec, 2006

3.0 – Elaboration Phase 3

Refactored menu system and added State Pattern, which caused changes in many scenario diagrams.

Bob Lavey

30 Dec, 2006

3.1 – Elaboration Phase 3

Added Enter Menus and Exit Menus scenario diagrams.

Bob Lavey

31 Dec, 2006

3.2 – Elaboration Phase 3

Added View Playlist scenario diagrams.

Bob Lavey

01 Jan, 2007

3.3 – Elaboration Phase 3

Added Stop Music scenario diagrams.

Bob Lavey

06 Jan, 2007

3.4 – Elaboration Phase 3

Modified Download a Song scenario diagram to add support for saving/retrieving the last known downloaded song’s path.

Bob Lavey

06 Jan, 2007

3.5 – Elaboration Phase 3

Added View Playlist scenario diagrams.

Bob Lavey

12 Jan, 2007

3.6 – Elaboration Phase 3

Updated nearly all of the scenario diagrams to split the application layer from the UI layer.  Included UI scenario diagrams in section 3.

Bob Lavey

13 Jan, 2007

3.7 – Elaboration Phase 3

Added Delete Song scenario diagrams.

Bob Lavey

14 Jan, 2007

3.8 – Elaboration Phase 3

Modified Play Song 2.4.2 scenario diagram to add volume setting.

Bob Lavey

15 Jan, 2007

3.9 – Elaboration Phase 3

Added Volume Adjustments scenario diagrams.

Bob Lavey

19 Jan 2007

3.10 – Elaboration Phase 3

Updated based on Dr. Leavens’ review.  Removed the system from the Enter Menus and Exit Menus scenario diagrams, since they’re UI use cases.

Bob Lavey

20 Jan 2007

3.11 – Elaboration Phase 3

Updated based on Dr. Leavens’ review.  Modified scenario diagrams whose first message was not from the top left corner.

Bob Lavey

 


Table of Contents

1.         Introduction. 6

1.1.    Purpose  6

1.2.    Scope  6

1.3.    Definitions, Acronyms, and Abbreviations  6

1.4.    References  6

1.5.    Overview   6

2.         Sequence Diagrams. 7

2.1.    Power On  7

2.1.1.    Music Listener Tells the System to Power On  7

2.1.2.    System State Initializes to a Default State  9

2.1.3.    Music Player Writes Song Collection  9

2.2.    Power Off  10

2.2.1.    Music Listener Tells the System to Power Off  10

2.3.    Select Playlist Order  11

2.4.    Play Music  11

2.4.1.    Music Listener Tells the System to Play  11

2.4.2.    Play Song  13

2.4.3.    Song Starts Playing  15

2.4.4.    Update Playing Song  17

2.4.5.    Playing Song Ends  19

2.5.    Pause Music  21

2.5.1.    Music Listener Tells the System to Pause  21

2.5.2.    Song is Paused  23

2.6.    Stop Music  25

2.6.1.    Music Listener Tells the System to Stop  25

2.6.2.    Song is Stopped  27

2.7.    Skip to the Next Song  29

2.8.    Restart the Current Song  29

2.9.    Skip to the Previous Song  29

2.10.  Volume Adjustments  29

2.10.1.      Music Player Gets the System Volume  29

2.10.2.      Music Player Sets the System Volume  29

2.11.  Download a Song  31

2.11.1.      Playlist Administrator Tells the System to Download a Song  31

2.12.  Delete a Song  31

2.12.1.      Playlist Administrator Retrieves the Playlist From the System   31

2.12.2.      Playlist Administrator Tells  the System to Delete a Song  31

2.13.  View Playlist 33

2.13.1.      Playlist Administrator Retrieves the Playlist From the System   33

3.         UI Sequence Diagrams. 33

3.1.    Power On  33

3.1.1.    UI Displays Initializing Message  33

3.1.2.    UI Displays Ready Message  34

3.2.    Power Off  35

3.2.1.    User Presses the Power Button  35

3.3.    Select Playlist Order  36

3.4.    Play Music  36

3.4.1.    User Presses Play Button  36

3.4.2.    Update UI With Playing Song  37

3.5.    Pause Music  38

3.5.1.    User Presses Pause Button  38

3.5.2.    Update UI With Paused Song  39

3.6.    Stop Music  40

3.6.1.    User Presses Stop Button  40

3.7.    Skip to the Next Song  41

3.8.    Restart the Current Song  41

3.9.    Skip to the Previous Song  41

3.10.  Volume Adjustments  41

3.10.1.      User Presses Up Button  41

3.10.2.      User Presses Down Button  42

3.11.  Download a Song  43

3.11.1.      User Selects Download a Song From the Main Menu  43

3.12.  Delete a Song  45

3.12.1.      User Selects Delete Song from the Main Menu  45

3.12.2.      User Selects Song to Delete  45

3.13.  View Playlist 46

3.13.1.      User Selects View Playlist from the Main Menu  46

3.13.2.      Create Playlist Viewer  48

3.13.3.      Display Playlist Viewer Pane  50

3.13.4.      User Presses Left Button to Return to the Main Menu  52

3.13.5.      Move to Previous Pane  52

3.14.  Enter Menus  54

3.14.1.      User Presses Menu Button  54

3.14.2.      Enter Menus  54

3.15.  Exit Menus  56

3.15.1.      User Presses Menu Button  56

3.15.2.      Exit Menus  56


 

Sequence Diagram Specification

1.                   Introduction

1.1.              Purpose

This document provides the detailed Sequence Diagrams for the Tanager project.  Sequence Diagrams will be generated for all main success scenarios, frequently-used scenarios, and complex scenarios.  The section numbering for the Sequence Diagrams will match that used in the Tanager System Sequence Diagram Specification and the Tanager Use Case Specification.  This will make it easier for the reader to match the Sequence Diagrams with the SSDs and the Use Cases.

1.1.              Scope

This document describes the Sequence Diagrams for the Tanager project.

1.2.              Definitions, Acronyms, and Abbreviations

A complete list of definitions, acronyms, and abbreviations can be found in the Tanager Glossary.

1.3.              References

Tanager Use Case Specification. 2007.  Bob Lavey.  15 January, 2007 <TanagerUseCaseModel.htm>.

Tanager System Sequence Diagram Specification. 2007.  Bob Lavey15 January, 2007 <TanagerSystemSequenceDiagramSpecification.htm>.

Tanager Class Model. 2007.  Bob Lavey.  15 January, 2007 <TanagerClassModel.htm>.

1.4.              Overview

This document provides a detailed view of the internal interactions between software objects in the Tanager system.  The sequence diagrams contained in this document will describe how the class objects from the Tanager system will interact to complete the objectives described in the Use Cases.


2.                   Sequence Diagrams

2.1.              Power On

2.1.1.         Music Listener Tells the System to Power On

 (click on image for a scaleable version)

2.1.2.         System State Initializes to a Default State

(click on image for a scaleable version)

2.1.3.         Music Player Writes Song Collection

 (click on image for a scaleable version)

 

2.2.              Power Off

2.2.1.         Music Listener Tells the System to Power Off

 (click on image for a scaleable version)

 

2.3.              Select Playlist Order

2.4.              Play Music

2.4.1.         Music Listener Tells the System to Play

(click on image for a scaleable version)

2.4.2.         Play Song

(click on image for a scaleable version)

2.4.3.         Song Starts Playing

(click on image for a scaleable version)

2.4.4.         Update Playing Song

(click on image for a scaleable version)

2.4.5.         Playing Song Ends

(click on image for a scaleable version)

 

2.5.              Pause Music

2.5.1.         Music Listener Tells the System to Pause

(click on image for a scaleable version)

2.5.2.         Song is Paused

(click on image for a scaleable version)

 

2.6.              Stop Music

2.6.1.         Music Listener Tells the System to Stop

(click on image for a scaleable version)

2.6.2.         Song is Stopped

(click on image for a scaleable version)

 

2.7.              Skip to the Next Song

2.8.              Restart the Current Song

2.9.              Skip to the Previous Song

2.10.           Volume Adjustments

2.10.1.     Music Player Gets the System Volume

(click on image for a scaleable version)

2.10.2.     Music Player Sets the System Volume

(click on image for a scaleable version)

 

2.11.           Download a Song

2.11.1.     Playlist Administrator Tells the System to Download a Song

(click on image for a scaleable version)

 

2.12.           Delete a Song

2.12.1.     Playlist Administrator Retrieves the Playlist From the System

This is identical to the scenario diagram of the same name in Section 2.13.1.

2.12.2.     Playlist Administrator Tells  the System to Delete a Song

(click on image for a scaleable version)

 

2.13.           View Playlist

2.13.1.     Playlist Administrator Retrieves the Playlist From the System

(click on image for a scaleable version)

 

 

3.                   UI Sequence Diagrams

3.1.              Power On

3.1.1.         UI Displays Initializing Message

 (click on image for a scaleable version)

3.1.2.         UI Displays Ready Message

 (click on image for a scaleable version)

 

3.2.              Power Off

3.2.1.         User Presses the Power Button

 (click on image for a scaleable version)

 

3.3.              Select Playlist Order

3.4.              Play Music

3.4.1.         User Presses Play Button

(click on image for a scaleable version)

3.4.2.         Update UI With Playing Song

(click on image for a scaleable version)

 

3.5.              Pause Music

3.5.1.         User Presses Pause Button

(click on image for a scaleable version)

3.5.2.         Update UI With Paused Song

(click on image for a scaleable version)

 

3.6.              Stop Music

3.6.1.         User Presses Stop Button

(click on image for a scaleable version)

 

3.7.              Skip to the Next Song

3.8.              Restart the Current Song

3.9.              Skip to the Previous Song

3.10.           Volume Adjustments

3.10.1.     User Presses Up Button

(click on image for a scaleable version)

3.10.2.     User Presses Down Button

(click on image for a scaleable version)

 

3.11.           Download a Song

3.11.1.     User Selects Download a Song From the Main Menu

(click on image for a scaleable version)

 

3.12.           Delete a Song

3.12.1.     User Selects Delete Song from the Main Menu

(click on image for a scaleable version)

3.12.2.     User Selects Song to Delete

(click on image for a scaleable version)

 

3.13.           View Playlist

3.13.1.     User Selects View Playlist from the Main Menu

(click on image for a scaleable version)

3.13.2.     Create Playlist Viewer

(click on image for a scaleable version)

3.13.3.     Display Playlist Viewer Pane

(click on image for a scaleable version)

3.13.4.     User Presses Left Button to Return to the Main Menu

(click on image for a scaleable version)

3.13.5.     Move to Previous Pane

(click on image for a scaleable version)

 

3.14.           Enter Menus

3.14.1.     User Presses Menu Button

(click on image for a scaleable version)

3.14.2.     Enter Menus

(click on image for a scaleable version)

 

3.15.           Exit Menus

3.15.1.     User Presses Menu Button

(click on image for a scaleable version)

3.15.2.     Exit Menus

(click on image for a scaleable version)