Please do not read over this mini-project until we have discussed it in class.
An associative array is a common data structure, similar to the association lists (or hashes) that you may have learned about in CSC-151. Since it’s a data structure, we’ll start by considering the layout of the associative array in memory.
In essence, an associative array is an (expandable) array of key/value pairs, intended to support looking up values by key. I think of them something like the following:
+---+
size: | 3 |
+---+
pairs:
+---+ +---+---+
| *-------------------------------------------------> | * | * |
+---+ +---+---+ +-|-+-|-+
| *--------------------------------> | * | * | | v
+---+ +---+---+ +-|-+-|-+ | +----------+
| *--------------> | * | * | | v | | V value0 |
+---+ +-|-+-|-+ | +----------+ | +----------+
| / | | v | | V value1 | v
+---+ | +----------+ | +----------+ +--------+
| / | | | V value2 | | | K key0 |
+---+ | +----------+ v +--------+
| / | | +--------+
+---+ | | K key1 |
| | v +--------+
. +--------+
. | K key2 |
. +--------+
That is, we have an array of Key/Value pairs along with an accompanying size
field to keep track of how many pairs are in the array. The array may have some empty space, which we fill with null
values. In the diagram, we’ve put all the nulls at the end. However, you might decide that it’s more natural to leave some nulls in the middle.
Associative arrays are most frequently used to implement the Dictionary
or Map
abstract data types. Both are names for structures that allow you to store associate values with corresponding keys. (Each key has only one value; multiple valeus may have the same key.)
The central methods for such types include the following:
public void set(K key, V value)
public V get(K key)
public boolean hasKey(K key)
public void remove(K key)
public int size()
public String toString()
"{key0:value0, key1:value1, ... keyn:valuen}"
If the array is empty, you should return "{}"
.public AssociativeArray<K,V> clone()
As you might expect, the first four procedures will need to iterate the array of key/value pairs, stopping when they find a matching key or run out of pairs. We normally use the equals
method to determine matching keys.
We will be sharing test cases in this project, which means that we will have two GitHub repositories: One for your AssociativeArray
code and one for the shared tests. Using the strategy means that we’ll have to do a slightly more complex setup. Cross your fingers that it works correctly.
a. Fork the repository at https://github.com/Grinnell-CSC207/mp-associative-arrays-maven.
b. Clone that repository.
cd ~/CSC207/MPs # Or the directory of your choice
git clone git@github.com:USERNAME/mp-associative-arrays-maven.git
c. Open the project in VSCode.
d. Update the README.md
appropriately.
e. Push the updated README
to GitHub.
cd ~/CSC207/MPs/ # Or the directory of your choice
cd mp-associative-arrays-maven
git add README.md
git status
git commit -m "Update README to include myself."
git pull
git push
f. Add an upstream repository just in case I make changes.
cd ~/CSC207/MPs/ # Or the directory of your choice
cd mp-associative-arrays-maven
git remote add upstream https://github.com/Grinnell-CSC207/mp-associative-arrays-maven
In the future, you can grab changes using the following.
git fetch upstream
git merge upstream/main
You can also just click the Sync Fork button on your GitHub page for the fork.
g. Make sure that you can run the experiment in VSCode.
h. You should see two sets of testing files. Make sure that you can run the current tests in VSCode.
i. Make sure that you can run the experiment in Maven.
cd ~/CSC207/MPs/ # Or the directory of your choice
cd mp-associative-arrays-maven
mvn exec:java -q
j. Make sure that you can run the tests in Maven.
cd ~/CSC207/MPs/ # Or the directory of your choice
cd mp-associative-arrays-maven
mvn tests
h. Add some point, you should have received an invitation to our testing repo. If you didn’t receive such an invitation, contact SamR asap. Do not fork the testing repo. You will be pushing directly to that repo.
i. Clone the testing repository using the name shared
and place it in src/test/java/edu/grinnell/csc207
cd ~/CSC207/MPs/ # Or the directory of your choice
cd mp-associative-arrays-maven
cd src/test/java/edu/grinnell/csc207
git clone git@github.com:rebelsky/csc207-2024fa-associative-array-tests.git shared
j. Make sure that the new folder and test file show up in VSCode. You may have to quit and restart.
k. Make sure that you can run the new tests in VSCode.
l. Make sure that you can run the new tests in Maven.
As you know, good practice suggests that you should write tests before writing code. So start by writing tests. And the earlier you write tests, the better you support not just yourself, but your classmates.
Add at least three tests, including at least two “normal” cases and at least one edge case, to TestAssociativeArrays.java
in the shared testing repository. Please name them with a form like lastFirstTest1()
, lastFirstTest2()
, and lastFirstEdge1()
. For example, mine would be rebelskySamuelTest1()
, rebelskySamuelTest2()
, and rebelskySamuelEdge1()
.
Make sure that your tests do not break the test suite!
Do not test the toString
method; there are too many potential orders for the K/V pairs.
You should use the following process to add your tests.
a. Open TestAssociativeArrays.java
in VSCode.
b. Add your tests. Do your best to make sure that they are sensible. Ensure that they compile. Make sure that they are in the section of the file with your name. Your tests likely won’t pass since we haven’t written working code yet.
c. In the terminal, cd
to the shared directory.
cd ~/CSC207/MPs/ # Or the directory of your choice
cd mp-associative-arrays-maven
cd src/test/java/edu/grinnell/csc207/shared
d. Verify that you’ve made the appropriate changes.
git status
git diff
e. Commit your changes.
git add TestAssociativeArrays.java
git commit -m "Add my amazing tests."
f. As you know, you can’t push to a repository if it’s changed since you last pulled. Hence, it’s good practice to pull before pushing. Pull from the repository.
git pull
g. Ideally, you haven’t gotten any merge conflicts and you haven’t seen any problems. If you have merge conflicts and feel like you can resolve them yourself, please do so. If you have merge conflicts and can’t resolve them, or find that the code is broken, please reach out to SamR on Teams. (Don’t go on to the next step.)
h. You should now be able to push your changes (unless someone pushed their own changes while you were looking at the updated file).
git push
i. Drop me a message on teams so that I know that you’ve completed this step and can check your tests. (I may not check them immediately.)
j. You should make it a habit to regularly pull the updated tests.
Implement the AssociativeArray<K,V>
class in Java. You may not use any other Java classes that provide similar features, such as java.util.HashMap
; you must rely on an underlying plain Java array of KVPair<K,V>
objects.
You have three sets of tests to run.
TestsFromSam.java
.TestsFromStudent.java
.shared/TestAssociativeArrays.java
.You should make sure to update the first and last of those with some regularity.
If you prefer visual interfaces, you can update my tests by visiting your repo on GitHub and clicking Sync Fork.
If you prefer textual interfaces, you can update my tests by switching to the top level of your project and using the appropriate commands.
cd ~/CSC207/MPs/ # Or the directory of your choice
cd mp-associative-arrays-maven
git fetch upstream
git merge upstream/main
You can pull updates to the shared tests using the steps we discussed earlier.
cd ~/CSC207/MPs/ # Or the directory of your choice
cd mp-associative-arrays-maven
cd src/test/java/edu/grinnell/csc207/shared
git pull
I am likely to revisit this rubric.
Submissions that fail to meet any of these requirements will get an I.
[ ] Passes all the R tests.
[ ] Each class has an introductory Javadoc comment that indicates the author and purpose.
[ ] Includes a `README.md` file that contains the appropriate information
(authors, purpose, acknowledgements if appropriate).
[ ] All files compile correctly.
Submissions that fail to meet any of these requirements but meet all previous requirements will receive an R.
[ ] Passes all the M tests.
[ ] No more than ten errors from `mvn checkstyle:check`.
[ ] Added three tests to the `AssociativeArrayTests.java` file.
[ ] One of those three tests is an edge case (preferably named as such).
[ ] The `toString()` method appears to behave correctly. (Since the ordering
of key/value pairs is somewhat open, we can't readily check this with
unit tests.)
Submissions that fail to meet any of these requirements but meet all previous requirements will receive an M.
[ ] Passes all of the E tests.
[ ] Correctly handles `null` keys in `set`, `get`, and `hasKey`.
[ ] All (or most) repeated code has been factored out into individual methods.
[ ] All or most variable names are appropriate.
[ ] No errors from `mvn checkstyle:check`.
More forthcoming.
When will you provide us with more tests (in TestsFromSam
)?
Since a key part of this assignment is writing tests, I may never provide you with such tests. One would hope that 40+ students working together should be able to catch most errors.