OOP Lab Task 3 - Revizia istoricului

Zhascsi: /* Requirements */

2016-11-20T21:00:56Z

Requirements

Zhascsi: /* Requirements */

2016-11-20T20:58:25Z

Requirements

Zhascsi: /* Requirements */

2016-11-20T20:38:30Z

Requirements

Zhascsi: /* Submitting */

2016-11-09T23:35:25Z

Submitting

Zhascsi: /* Submitting */

2016-11-09T23:29:26Z

Submitting

Zhascsi: /* Submitting */

2016-11-09T23:28:37Z

Submitting

Zhascsi: /* Submitting */

2016-10-09T12:16:57Z

Submitting

Zhascsi la 18 noiembrie 2015 01:50

2015-11-18T01:50:34Z

Zhascsi la 18 noiembrie 2015 01:23

2015-11-18T01:23:49Z

Rhobincu: /* Requirements */

2014-11-23T20:38:06Z

Requirements

@@ Linia 38: / Linia 38: @@
 * Be sure, when you format the string, that the original message exists, otherwise format the full message as a simple message.
 * Since the base class fields are private you must rely on the base class read methods to get the formatted string of it's sender and content.
-* If the attached message has also an attachment, format it as stated for any full message.
+* If the attached message has also an attachment, format it as stated for any full message:
 <br>
 * Write another class called '''Main''' (the default class created if you created a project within NetBeans), which should contain only the '''main''' method, which instantiates an inbox, creates four messages, adds them to the inbox, and displays the messages read from the inbox (repeatedly calling the inbox read method - try to call it one more time, to see that no more message is displayed). That four messages will be:

@@ Linia 11: / Linia 11: @@
 * Create a Java application project, or open your previous one. The package name is <span style="font-family:'Lucida Console', monospace">labutil</span>.
-* Add to your project (if it's not already there) the classes '''Message''' and '''Inbox''' exactly as defined in OOP Lab Task 2. You may copy it from your uploaded archive of the previous assignment on the Web-CAT. Do not modify them!
+* Add to your project (if they are not already there) the classes '''Message''' and '''Inbox''' exactly as defined in OOP Lab Task 2. You may copy them from your uploaded archive of the previous assignment on the Web-CAT. Do not modify them!
 <br>
-* Create a new class '''FullMessage''' derived from the class '''Message'''. This class allows the creation of messages that are replies to other messages, such that a reply message has as an attachment the original message to which it replies. The original message may be in its turn a simple message or a reply message, in the latter case being a whole chain of reply to reply to reply a.s.o.
+* Create a new class '''FullMessage''' derived from the class '''Message'''. This class allows the creation of messages that are replies to other messages, such that a reply message has as an attachment the original message to which it replies. The attached message may be in its turn a simple message or a full message, in the latter case being a whole chain of reply to reply to reply a.s.o.
-* The '''FullMessage''' class additional field is the reference to the original message. This field is immutable and private, as are the fields of the base class.
+* The '''FullMessage''' class additional field is the reference to the attached message. This field is immutable and private, as are the fields of the base class.
 <br>
 * Add two constructors to this new class:
-** a constructor with three arguments, two strings for the sender' name and the reply text, and a reference to the original message. In its implementation use a call to the base class constructor.
+** a constructor with three arguments, two strings for the sender's name and the reply text, and a reference to the original message. In its implementation use a call to the base class constructor.
-** a constructor with two arguments, strings for the sender's name and the content of the message. This constructor instantiates a full message but without any attachment. Use a call to the previous constructor or a call to the other constructor.
+** a constructor with two arguments, strings for the sender's name and the content of the message. This constructor instantiates a full message but without any attachment. Use a call to the previous constructor.
 <br>
-* '''FullMessage''' class must override both read methods of the class Message, such that they return the formatted string for the sender and content, followed, if there is an attachment, by a delimiter on a separate line ("----------"), after which goes the formatted string of the attached message.
+* '''FullMessage''' class must override both read methods of the class Message, such that they return the formatted string for the sender and content (as stated for the '''Message''' class read methods), followed, if there is an attachment, by a delimiter on a separate line ("----------"), after which goes the formatted string of the attached message.
 For example, if the original message was:
@@ Linia 37: / Linia 37: @@
 Notes:
 * Be sure, when you format the string, that the original message exists, otherwise format the full message as a simple message.
-* Since the base class fields are private you must rely on the base class read methods to get the formatted string of the sender and the content.
+* Since the base class fields are private you must rely on the base class read methods to get the formatted string of it's sender and content.
 <br>
 * Write another class called '''Main''' (the default class created if you created a project within NetBeans), which should contain only the '''main''' method, which instantiates an inbox, creates four messages, adds them to the inbox, and displays the messages read from the inbox (repeatedly calling the inbox read method - try to call it one more time, to see that no more message is displayed). That four messages will be:

@@ Linia 10: / Linia 10: @@
 == Requirements ==
-* Create a Java application project whose package name is <span style="font-family:'Lucida Console', monospace">oop_lab3</span>.
+* Create a Java application project, or open your previous one. The package name is <span style="font-family:'Lucida Console', monospace">labutil</span>.
-* Add to your package the classes '''Message''' and '''Inbox''' exactly as defined in OOP Lab Task 2. Do not modify them!
+* Add to your project (if it's not already there) the classes '''Message''' and '''Inbox''' exactly as defined in OOP Lab Task 2. You may copy it from your uploaded archive of the previous assignment on the Web-CAT. Do not modify them!
 <br>
-* Create a new class '''FullMessage''' derived from the class '''Message'''. This class allows the creation of messages that are replies to other messages, such that a reply message has as an attachment the original message to which it replied. The original message may be in its turn a simple message or a reply message, in the latter case being a whole chain of reply to reply to reply a.s.o.
+* Create a new class '''FullMessage''' derived from the class '''Message'''. This class allows the creation of messages that are replies to other messages, such that a reply message has as an attachment the original message to which it replies. The original message may be in its turn a simple message or a reply message, in the latter case being a whole chain of reply to reply to reply a.s.o.
 * The '''FullMessage''' class additional field is the reference to the original message. This field is immutable and private, as are the fields of the base class.
 <br>
 * Add two constructors to this new class:
-** a constructor with three arguments, two strings for the sender and the content, and a reference to the original message. In its implementation use a call to the base class constructor.
+** a constructor with three arguments, two strings for the sender' name and the reply text, and a reference to the original message. In its implementation use a call to the base class constructor.
-** a constructor with two arguments, strings for the sender and the content of the message. This constructor instantiates a full message but without any attachment. Use a call to the previous constructor.
+** a constructor with two arguments, strings for the sender's name and the content of the message. This constructor instantiates a full message but without any attachment. Use a call to the previous constructor or a call to the other constructor.
 <br>
-* '''FullMessage''' class must override both read methods of the class Message, such that they return the formatted string for the sender and content followed by a delimiter on a separate line ("----------"), after which goes the formatted string of the attached message.
+* '''FullMessage''' class must override both read methods of the class Message, such that they return the formatted string for the sender and content, followed, if there is an attachment, by a delimiter on a separate line ("----------"), after which goes the formatted string of the attached message.
 For example, if the original message was:

@@ Linia 53: / Linia 53: @@
 * The assignment will be evaluated automatically by the [http://homework.dcae.pub.ro:/WebObjects/Web-CAT.woa Web-CAT] platform.
 * You could access the Web-CAT platform using the username and the password with which you acces the <span style="color:red">electronica.curs.pub.ro</span> intranet.
-* Select the OOP Laboratory 3 assignment.
+* Select the OOP Lab Task 3 assignment.
 * Submit your work as a single .zip archive (give it whatever name you choose) containing only the Java source code files.
 * <font color="red">'''Attention'''</font> Any deviation from these instructions may lead to the loss of the entire amount of points.

@@ Linia 51: / Linia 51: @@
 == Submitting ==
-* The assignment will be evaluated automatically by the [http://homework.dcae.pub.ro:/Web-CAT/WebObjects/Web-CAT.woa Web-CAT] platform.
+* The assignment will be evaluated automatically by the [http://homework.dcae.pub.ro:/WebObjects/Web-CAT.woa Web-CAT] platform.
 * You could access the Web-CAT platform using the username and the password with which you acces the <span style="color:red">electronica.curs.pub.ro</span> intranet.
 * Select the OOP Laboratory 3 assignment.
 * Submit your work as a single .zip archive (give it whatever name you choose) containing only the Java source code files.
 * <font color="red">'''Attention'''</font> Any deviation from these instructions may lead to the loss of the entire amount of points.

@@ Linia 7: / Linia 7: @@
 * [[Coding Conventions]]
 * [[Advanced Notions About Object Oriented Programming]]
 == Requirements ==
-# Write a class called '''ServerConfig''' which has the role of reading configuration values from a text file. This class will be used later on during the development of the server application, and needs to meet the following requirements:
+* Create a Java application project whose package name is <span style="font-family:'Lucida Console', monospace">oop_lab3</span>.
-#* The class needs to have two constructors:
+* Add to your package the classes '''Message''' and '''Inbox''' exactly as defined in OOP Lab Task 2. Do not modify them!
-#*# One with an argument of type String, which represents the file to be read
+* Create a new class '''FullMessage''' derived from the class '''Message'''. This class allows the creation of messages that are replies to other messages, such that a reply message has as an attachment the original message to which it replied. The original message may be in its turn a simple message or a reply message, in the latter case being a whole chain of reply to reply to reply a.s.o.
-#*# One without any arguments, which will implicitly consider the configuration file to be ''server.conf''.
+* The '''FullMessage''' class additional field is the reference to the original message. This field is immutable and private, as are the fields of the base class.
-#* Objects of type '''ServerConfig''' have to read the file, line by line, and then expose the parameters that were read through methods.
+* Add two constructors to this new class:
-#* The methods in class '''ServerConfig''' must throw exceptions if any issues arise when reading or parsing the file:
+** a constructor with three arguments, two strings for the sender and the content, and a reference to the original message. In its implementation use a call to the base class constructor.
-#*# '''IOException''' if the file is missing or it cannot be opened (this exception is already being thrown by stream related classes, so you only need to rethrow it further up the execution stack).
+** a constructor with two arguments, strings for the sender and the content of the message. This constructor instantiates a full message but without any attachment. Use a call to the previous constructor.
-#*# '''InvalidFormatException''' if at least one line from the file doesn't match the expected pattern (this type of exception doesn't exist and it needs to be created).
+<br>
-#*# '''UnknownKeyException''' if an unknown property is present in the file (this type of exception doesn't exist and it needs to be created).
+* '''FullMessage''' class must override both read methods of the class Message, such that they return the formatted string for the sender and content followed by a delimiter on a separate line ("----------"), after which goes the formatted string of the attached message.
 <syntaxhighlight lang="xorg_conf">
-PROPERTY=value
+John:How are you?
 </syntaxhighlight>
 <syntaxhighlight lang="xorg_conf">
-#this is a config file for the chat server!
+Mary:I'm fine, thanks!
-      #   this is made by ME!
+----------
-MAX_CLIENT=100
+John:How are you?
 </syntaxhighlight>
-'''Notes:'''
+== Submitting ==
-* The three types of exceptions which must be defined have very simple implementations. You need to define them as classes that extend class '''Exception''' and they only need to contain a constructor with an argument of type String that only calls the constructor of the super-class of the same type.
+* The assignment will be evaluated automatically by the [http://homework.dcae.pub.ro:8888/Web-CAT/WebObjects/Web-CAT.woa Web-CAT] platform.
-* The submitted files will be only Java implementations of the following classes: '''ServerConfig''', '''Main''', '''Message''', '''PrivateMessage''', '''InvalidFormatException''', '''UnknownKeyException''' and '''MissingKeyException'''.
+* You could access the Web-CAT platform using the username and the password with which you acces the <span style="color:red">electronica.curs.pub.ro</span> intranet.
-* The following classes and methods may be of use in implementing this assignment. Look them up in the API documentation:
+* Select the OOP Lab Task 3 assignment.
-** String.trim
+* Submit your work as a single .zip archive (give it whatever name you choose) containing only the Java source code files.
-** String.charAt
+* <font color="red">'''Attention'''</font> Any deviation from these instructions may lead to the loss of the entire amount of points.

@@ Linia 47: / Linia 47: @@
-'''Note:'''
+'''Notes:'''
-* Cele trei tipuri de excepții care trebuie definite au implementări foarte simple. Trebuie definite ca niște clase care extind clasa '''Exception''', și nu este nevoie să conțină decât definiția unui constructor cu un argument de tip String care nu face altceva decât să apeleze constructorul superclasei.
+* The three types of exceptions which must be defined have very simple implementations. You need to define them as classes that extend class '''Exception''' and they only need to contain a constructor with an argument of type String that only calls the constructor of the super-class of the same type.
-* Fișierele predate vor fi implementările Java a următoarelor clase: '''ServerConfig''', '''Main''', '''Message''', '''PrivateMessage''', '''InvalidFormatException''', '''UnknownKeyException''' și '''MissingKeyException'''.
+* The submitted files will be only Java implementations of the following classes: '''ServerConfig''', '''Main''', '''Message''', '''PrivateMessage''', '''InvalidFormatException''', '''UnknownKeyException''' and '''MissingKeyException'''.
-* Următoarele clase și metode vă pot fi de folos în realizarea temei. Căutați-le în documentația API:
+* The following classes and methods may be of use in implementing this assignment. Look them up in the API documentation:
 ** String.trim
 ** String.charAt
@@ Linia 59: / Linia 59: @@
 ** Integer.parseInt
 ** BufferedReader.readLine
-* Din cauza faptului că puteți avea două obiecte de tip '''String''' diferite (cu referințe diferite) dar care conțin același text, iar operatorul == compară referințele, modul corect prin care se compară două String-uri este prin apelarea metodei equals:
+* Because you can have two different objects of type '''String''' (with different references) which contain the same character sequence, and because operator == is used to compare references, the correct way to compare two Strings is by calling method equals:
 <syntaxhighlight lang="java">
 String a = "abc";
 String b = new String(a);
-if(a == b) { // <- incorect, evaluarea va întoarce false
+if(a == b) { // <- wrong, this is evaluated to false
    //...
+}
-if(a.equals(b)) { // <- corect, evaluarea va întoarce true
+if(a.equals(b)) { // <- correct, this is evaluated to true
    //...
+}