Project #4 Implementation Details

P4 Implementation Details

Note: there may be some corrections, but this is being posted now so you know the names of the various fields. Make sure to check back in a few days, in case corrections are made.

The following are a list of TextField objects that should be declared as private members of Gui. You can make it public, but instead, a better way is to keep variables private by creating a SimpleMap which maps strings to Widget * just like the tester classes did, and then overload the operator[] to access. This time, when you access the object, it will either be a Button or TextField and you may need to dynamic cast to get the correct object.

That's a better solution than making the data members public.

TextField objects in Gui

The following are a list of the names of TextField objects. You should add these as TextField * data members of Gui and initialize in the constructor. You may wish to write a function called trim() which removes blanks at the beginning and end of lines to help you edit the input, when you retrieve it from the TextGui object (see the header file for methods provided). Notice that most entries have possible leading or trailing blanks.

name The user enters the name on one line. The input syntax is:
<mblanks> <word> <blanks> <word> <mblanks>
That is, the user enters first and last name, and there may be blanks before and after and in the middle. Hint: use your code for Movie to "split" this apart.
You may assume no two names are the same.
alias This is the alias of the user. You may assume aliases (like names) are unique. The alias is a single word. The input syntax is:
<mblanks> <word> <mblanks>

You may assume that no two aliases are the same.
friendAlias This is the alias of a user's friend. It has the same syntax as alias.
payment The payment for the user, when applying for membership.
<mblanks> <digits> <mblanks>
You may assume the input is positive. You have to translate this from a string to a number (hint: see previous projects, this function may already exist).
couponType Again, some digits, representing the worth of a coupon when applying for membership. You may assume the value is non-negative.
<mblanks> <digits> <mblanks>
hasReferral true, if applicant (user) has referral, false otherwise. Again, used for applying for membership.
<mblanks> [ "true" | "false" ] <mblanks>
yrsMember Number of years that a user has been a member already. Used in application. You may assume the value is a non-negative integer.
<mblanks> <digits> <mblanks>
date The date.
<mblanks> [ "January" | "February" | "March" | "April" | "May" | "June" | "July" | "August" | "September" | "October" | "November" | "December" ] <mblanks> <digits> "," <mblanks> <digit>{4,4} <blanks> <digit> [<digit>]? ":" <digit> <digit> <blanks> [ "AM" | "PM" ] <mblanks>
You can assume the digits are sensible for the month. You can ignore leap year. You can assume the years start in 1990 and afterwards, though it would be nice to handle a wider range of years. This is perhaps the most important field you have to manage.
Note: the comma comes immediately after the day.
This includes the day, and the time. All of this appears on one line.
origDate The original date of a posting. Used for following up. Has the same format as date
title Title of an MP3 song, or title of the journal entry. This is for initial posting of journal entries.
<mblanks> <word> [ <blanks> <word> ] <mblanks>
duration The length of a song in minutes and seconds
<mblanks> <digits> <blanks> <digits> <mblanks>
You may assume the minutes are seconds are non-negative
albumTitle Name of album where the song appears. For MP3 postings. Same BNF as title.
artistName Name of artist for MP3. Assume it is the name of a person.
body The text printed in the body of a journal entry. This may contain more than one line.
goodFriend True or false, depending on whether friend is "good" or just so-so.
emoticon Associated with friend. A string of non-blank characters.
```
<mblanks> <string> lt;mblanks>
```
number A number. The syntax is the same as yrsMember.

Output BNF

The output BNF will have a similar structure to the previous projects
<output> := <line> [ ["Button Pressed: (" <word> ")" <endl> <out> <line>]+ | "NO BUTTONS PRESSED" <endl> <line> ] <endl> <line> ::== "----*----*----*----*----*----*----*----*" <endl>
You should produce output only when buttons are pressed (no output when entering text fields). The first line printed indicates the button pressed. The following lines printed are indicated below. So, the first line of each output is the name of the button pressed, followed by whatever output is specified in the next section. Here's an example of the output.
----*----*----*----*----*----*----*----* Button Pressed: (apply) ....more stuff.... ----*----*----*----*----*----*----*----*

Buttons Specifications

The following are a list of buttons. Each button corresponds to an operation.

apply
The TextField objects used with this are:
- name
- alias
- payment
- couponType
- hasReferral
- yrsMember
- date
Use this to store information about a person. Note that these objects are strings and may have to be converted to other types for internal storage.
The output BNF for this is:
```
<out> := <name> " (" <alias> ") " has "
                [ "GOLD" | "SILVER" | "BRONZE" | "NO" ]
               " membership " as of " (" <date> ")"
<name> := <word> ", " <word> 
<date> := <digit> [<digit>]?  "/"
                <digit> [<digit>]?  "/"
                <digit> <digit>
```
The name is printed last name followed by comma, space, and then the first name. The alias is the same as entered in. The date has the format that looks like "4/2/02" The year is printed as two digits. You may assume years begin after 1990 and is before, say, 2010.
addFriend
The TextField objects used with this are:
- alias Your alias
- friendAlias Your friend's alias
- goodFriend Whether your friend is a "good" friend or not
- emoticon The emoticon associated with your friend. Ignored if goodFriend is false.
The output BNF for this is:
```
<out2> := <name> " (" <alias> ") " 
                [ "SUCCESSFULLY ADDS" | "IS ALREADY FRIENDS WITH" ]
                <name> " (" <alias> ") " 
                [ "Emoticon: " <word> ]?
```
You may assume that the friend has already successfully been added as a member (only members may be friends). The first name and alias are your name and alias. The second name and alias are your friend's name and alias. If your friend is a "good friend", print out the emoticon too.
removeFriend
The text fields used are:
- alias Your alias
- friendAlias Your friend's alias
The output BNF for this is:
<out2> := <name> " (" <alias> ") " [ "SUCCESSFULLY REMOVES" | "IS NOT FRIENDS WITH" ] <name> " (" <alias> ") " [ "Emoticon: " <word> ]?
You may assume that friendAlias is a legitmiate alias. However, you may NOT assume that the friend is your friend (thus, you may fail to remove the friend from your list). Notice that you will have to locate your friend's real name somewhere.
If you are not friends with the person listed, the no emoticon is printed.
Hint: to handle friends, you may wish to create a Friend class that contains a Name and a GoodFriend class derived from Friend that contains the emoticon. Then, the list of friends is stored as a BST of Friend * objects.
You do not have to be very efficient about accessing friends, etc., but you may want to think about how efficient it is to find things.
listFriends
The text fields used are:
- alias Your alias
This will print a BST of friends in the tree like format from Project 3. For regular friends, print out:
<name> " (" <alias> ") "
which is last name, then first, then a space, and the alias in parentheses.
If it's a good friend, list:
```
<name> " (" <alias> ") Emoticon: " <string>
```
where the string is the emoticon
listFriendsIn
The text fields used are:
- alias Your alias
This lists friends in inorder, just as in Project 3, where friends are printed using the syntax shown in listFriends. If there are no friends, print "EMPTY LIST", just as you did in Project 3. The output should handle regular and "good" friends.
postJournal
The text fields used are:
- alias Your alias
- date The date that the article was posted
- title The "title" of your journal entry
- body The "body" of the journal entry
When posting journal entries, you will have to be careful how many entries have been posted on that day. This will be discussed in the next section.
The output is:
```
<out> := "Journal entry for " <name> 
               [ "SUCCESSFULLY POSTED" | 
                 "NOT POSTED! Exceeds limit of " <digits> ]
```
No alias is posted. If successful, it is "posted" (i.e., recorded). If it exceeds limits, it is not posted. Limits are discussed below.
postMp3
The text fields used are:
- alias Your alias
- date The date that the MP3 was posted
- title The "title" of an MP3 song
- artist The "artist" (name of a person)
- album Name of album where the song appeared
- duration How many minutes and seconds song lasts
The output is:
<out> := "MP3 for " <name> [ "SUCCESSFULLY POSTED" | "NOT POSTED! Exceeds limit of " <digits> ]
No alias is posted. If successful, it is "posted" (i.e., recorded). If it exceeds limits, it is not posted. Limits are discussed below.
list
The text fields are:
- alias
- number how many journal entries/MP3 to print
This is the key display feature for a person.
The output is:
```
"Listing for " <name> " (" <alias> ")" <endl>
"====*====*====*====*====*====*====*====*"
```
Here's an example of a journal entry. How to follow up to a journal will be explained in a later section.
JOURNAL Name: Doe, John Alias: jarjar Title: "Why Economic Reform is a Joke" Date: 4/2/02 12:20 PM Just because it is!
It has the word JOURNAL on one line, "Title:", followed by the title in double quotes on the next line, "Date: " followed by the date. Then, one blank line, and all the lines of the journal entry.
For an MP3, you have:
```
MP3
Name: Doe, John    Alias: jarjar
Title: "Eat it"
Artist: Yankovic, Al   Album: "In 3-D"   Duration: 170
Date: 4/2/02  
```
You will list out the "N" most recent TOP-LEVEL entries (ignoring any followups), where "N" is specified by the <number> field. A TOP-LEVEL entry means you ignore followups when counting. Each entry should be separated from the next with one blank line. If there are fewer than "N" entries, then print the number of entries there are (both MP3 and journals). If there are zero entries, print "NO ENTRIES".
listFriends
The text fields are:
- alias
- number how many journal entries/MP3 to print
You should print the journal entries of all friends in reverse chronological order, up to number entries. In effect, pretend all your friends had their top-level entries, sorted by date, in one big batch.
You pick the most recent N where N is the value in number.
Use the same rules as list if there are too few entries or none at all.
For good friends, you should print:
```
Name: Doe, John  Emoticon: ;-)   Alias: jarjar
```
That is, add the emoticon.
This is a TOUGH function. (At least, I think it is...).
followup
The text fields are:
- alias Your alias
- friendAlias Your friend's alias (doesn't have to be a friend, though).
- date The date you posted
- origDate The original date of the posting that you are following up to.
This is the "hardest" of the tasks to do (perhaps by far).
You will need to find a friend (actually, anyone with an alias, including yourself) and the date of the original posting. The followup For followups, you should indent 5 * K spaces in, for the followup depth. For example, if the depth is 1 (meaning first followup), you indent everything 5 spaces in. You may only followup with journal entries. You can followup on either a journal entry or an MP3, but only with a followup entry.
A followup to a follow up has a followup of depth 2. So, that would mean indent the entry 10 spaces in.
The following is an example of a followup of depth 1. It is indented 5 steps in.
```
     FOLLOWUP
     Name: Jain, Ani  Emoticon: ;-)   Alias: desi
     Title: "Why Economic Reform is a Joke"
     Date: 4/2/02
     Original Date: 
     Just because it is!
```
You should print the following for a followup:
<name> " (" <alias> ") follows up to " <name> " (" <alias> ") " [ "SUCCESSFULLY" | "FAILS" ]

A follow up fails if there is no article at that date and time. It also fails if the followup time is BEFORE the time of the article it follows up.

GOLD, SILVER, BRONZE

Each member will have one of three kinds of memberships.

GOLD Unlimited postings
SILVER Can post only 2 posts a day, and up to 2 followups. (so 4 posts total)
BRONZE Can post once a day, either a regular post or a follow.

The primary input will only have members with GOLD membership to make your life easier.

Followups

You can followup to any journal entry or MP3. The followup will always be another journal entry. Followups can also be followed up. For example, if member A posts an article, then any member can post a followup to A (say, member B). Suppose member C follows up to A. Then, the output looks like:
AAAAAA AAAAAA BBBBBB BBBBBB CCCCCC CCCCCC
assuming that B's article has a date that occurs before C's article.

Assumptions

The commands are not guaranteed to be given in chronological order. For example, the input file may post a journal entry on October 2, 2000, then a journal entry on May 10, 2000.

Strategy

TO BE POSTED

Web Accessibility