OOP Lab Task 4 - Revizia istoricului

Zhascsi: /* Requirements */

2016-12-04T22:43:12Z

Requirements

Zhascsi: /* Requirements */

2016-12-04T22:41:05Z

Requirements

Zhascsi: /* Requirements */

2016-12-04T21:47:34Z

Requirements

Zhascsi: /* Submitting */

2016-11-09T23:35:13Z

Submitting

Zhascsi: /* Submitting */

2016-11-09T23:30:02Z

Submitting

Zhascsi: /* Submitting */

2016-10-09T12:17:28Z

Submitting

Zhascsi: /* Requirements */

2015-12-02T04:15:40Z

Requirements

Zhascsi: /* Requirements */

2015-12-02T03:59:28Z

Requirements

Zhascsi: /* Requirements */

2015-12-02T03:53:31Z

Requirements

Zhascsi: /* Requirements */

2015-12-02T03:50:05Z

Requirements

@@ Linia 26: / Linia 26: @@
 #* The class must have a public method, named '''read''', with only one argument, a string. When called with a valid configuration parameter name the method returns the value of that parameter, otherwise it throws an exception of type '''UnknownKeyException''', with the invalid name given as the exception's detail message string.
 # '''InvalidFormatException''', '''UnknownKeyException''' and '''MissingKeyException''' types are all derived from the '''ConfigureException''' type, which is in its turn derived from '''Exception''' class, and must also be defined.
-#* The types of exceptions which must be defined have very simple implementations. You need to define them as classes that extend their base classes. Only the '''UnknownKeyException''' class has something in it's body: a constructor with an argument of type String needed to get the invalid/unknown configuration parameter name, and that constructor will simply call the constructor of the super-class with that name as argument.
+#* The types of exceptions which must be defined have very simple implementations. You need to define them as classes that extend their base classes. Only the '''UnknownKeyException''' class has something in its body: a constructor with an argument of type String needed to get the invalid/unknown configuration parameter name, and that constructor will simply call the constructor of the super-class with that name as argument.
 # Only these following configuration parameter names are allowed in the configuration file:
 #* TCP_PORT - the TCP port on which the server will be listening on.

@@ Linia 26: / Linia 26: @@
 #* The class must have a public method, named '''read''', with only one argument, a string. When called with a valid configuration parameter name the method returns the value of that parameter, otherwise it throws an exception of type '''UnknownKeyException''', with the invalid name given as the exception's detail message string.
 # '''InvalidFormatException''', '''UnknownKeyException''' and '''MissingKeyException''' types are all derived from the '''ConfigureException''' type, which is in its turn derived from '''Exception''' class, and must also be defined.
-#* The types of exceptions which must be defined have very simple implementations. You need to define them as classes that extend their base classes. Only the '''UnknownKeyException''' needs to contain a constructor with an argument of type String needed to retain the invalid/unknown configuration parameter name, and that constructor will simply call the constructor of the super-class.
+#* The types of exceptions which must be defined have very simple implementations. You need to define them as classes that extend their base classes. Only the '''UnknownKeyException''' class has something in it's body: a constructor with an argument of type String needed to get the invalid/unknown configuration parameter name, and that constructor will simply call the constructor of the super-class with that name as argument.
 # Only these following configuration parameter names are allowed in the configuration file:
 #* TCP_PORT - the TCP port on which the server will be listening on.

@@ Linia 13: / Linia 13: @@
 == Requirements ==
-# Write a class called '''ServerConfig''' whose purpose is to hold configuration values read 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:
+# Add to the '''labutil''' package a class named '''ServerConfig''' whose purpose is to hold configuration values read 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:
 #* The class must have two constructors:
 #*# One with an argument of type String, which is the name of the file to read from;
@@ Linia 55: / Linia 55: @@
 '''Notes:'''
 * Be carefull to name your classes exactly '''ServerConfig''', '''Main''', '''ConfigureException''', '''InvalidFormatException''', '''UnknownKeyException''' and '''MissingKeyException'''. Also the public method of the '''ServerConfig''' class must be named '''read'''.
 * Some of the following classes and methods may be of use for your implementation. Look them up in the API documentation:
 ** String.trim

@@ Linia 89: / Linia 89: @@
 * 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 4 assignment.
+* Select the OOP Lab Task 4 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 87: / Linia 87: @@
 == 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 Lab Task 4 assignment.
+* Select the OOP Laboratory 4 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 54: / Linia 54: @@
 <br>
 '''Notes:'''
-* The submitted files will be only Java implementations of the following classes: '''ServerConfig''', '''Main''', '''ConfigureException''', '''InvalidFormatException''', '''UnknownKeyException''' and '''MissingKeyException'''.
+* Be carefull to name your classes exactly '''ServerConfig''', '''Main''', '''ConfigureException''', '''InvalidFormatException''', '''UnknownKeyException''' and '''MissingKeyException'''. Also the public method of the '''ServerConfig''' class must be named '''read'''.
+* Some of the following classes and methods may be of use for your implementation. Look them up in the API documentation:
 ** String.trim
 ** String.charAt
@@ Linia 79: / Linia 78: @@
 * To be able to read from a text file, instantiate a '''BufferedReader''' object and use a '''BufferedReader''' reference, so that to be able to call its method '''readLine'''. At each call this method returns the next line of the file as a string (but without the newline character). After the end of file is reached the method returns a null string.
-* For the '''BufferedReader''' object you need only its constructor and the methods '''redLine''' and '''close'''.
+* For the '''BufferedReader''' object you need only its constructor and the methods '''readLine''' and '''close'''.
 == Submitting ==

@@ Linia 27: / Linia 27: @@
 # '''InvalidFormatException''', '''UnknownKeyException''' and '''MissingKeyException''' types are all derived from the '''ConfigureException''' type, which is in its turn derived from '''Exception''' class, and must also be defined.
 #* The types of exceptions which must be defined have very simple implementations. You need to define them as classes that extend their base classes. Only the '''UnknownKeyException''' needs to contain a constructor with an argument of type String needed to retain the invalid/unknown configuration parameter name, and that constructor will simply call the constructor of the super-class.
-# Only these following property names are allowed in the configuration file:
+# Only these following configuration parameter names are allowed in the configuration file:
 #* TCP_PORT - the TCP port on which the server will be listening on.
 #* MAX_CLIENTS - the maximum number of clients that the server application may serve.
@@ Linia 36: / Linia 36: @@
 * A parameter-value pair must be written as an assignment:
 <syntaxhighlight lang="xorg_conf">
-PROPERTY=value
+PARAMETER=value
 </syntaxhighlight>
 * Spaces or tabs around the equal sign are also ignored.
@@ Linia 79: / Linia 79: @@
 * To be able to read from a text file, instantiate a '''BufferedReader''' object and use a '''BufferedReader''' reference, so that to be able to call its method '''readLine'''. At each call this method returns the next line of the file as a string (but without the newline character). After the end of file is reached the method returns a null string.
 == Submitting ==

@@ Linia 21: / Linia 21: @@
 #*# '''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 or declare that it is thrown).
 #*# '''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 defined).
-#*# '''UnknownKeyException''' if an unknown property is present in the file (this type of exception doesn't exist and it needs to be defined).
+#*# '''UnknownKeyException''' if an unknown property is present in the file (this type of exception doesn't exist and it needs to be defined). This exception retains also the offending name as its detail message string.
 #*# '''MissingKeyException''' if one of the valid properties is missing from the file (this type of exception doesn't exist and it needs to be defined).
 #* The '''ServerConfig''' class must be immutable. The configuration parameters read from file must be stored as instance constants inside the '''ServerConfig''' object.
@@ Linia 33: / Linia 32: @@
 # All property values are integers.
 # Write a test for this class (which should open a file, read its contents and print the read parameters on the screen) and add it to the main method in class '''Main'''.
+<br>
 The configuration file that the '''ServerConfig''' class constructor reads is a plain text file, containing only comments, blank spaces, and parameter-value pairs.
 * A parameter-value pair must be written as an assignment:
@@ Linia 53: / Linia 52: @@
      TCP_PORT = 9000
 </syntaxhighlight>
+<br>
 '''Notes:'''
 * The submitted files will be only Java implementations of the following classes: '''ServerConfig''', '''Main''', '''ConfigureException''', '''InvalidFormatException''', '''UnknownKeyException''' and '''MissingKeyException'''.
@@ Linia 79: / Linia 78: @@
 </syntaxhighlight >
-* To be able to read from a text file, instantiate a '''BufferedReader''' object and use a '''BufferedReader''' reference, so that to be able to call its method '''readLine'''. At each call this method returns the next line of the file as a string (but without the newline character). After the file end is reached the method returns a null string.
+* To be able to read from a text file, instantiate a '''BufferedReader''' object and use a '''BufferedReader''' reference, so that to be able to call its method '''readLine'''. At each call this method returns the next line of the file as a string (but without the newline character). After the end of file is reached the method returns a null string.
 == Submitting ==