]> git.mxchange.org Git - addressbook-swing.git/blobdiff - Addressbook/src/org/mxchange/addressbook/database/backend/csv/CsvDatabaseBackend.java
Now much easier to handle
[addressbook-swing.git] / Addressbook / src / org / mxchange / addressbook / database / backend / csv / CsvDatabaseBackend.java
index 9f3e8329fbd41f04df9372490969ed228ca76d93..c5f41e0204a90055b1c426a076c2a3188ee4f858 100644 (file)
-/*\r
- * Copyright (C) 2015 Roland Haeder\r
- *\r
- * This program is free software: you can redistribute it and/or modify\r
- * it under the terms of the GNU General Public License as published by\r
- * the Free Software Foundation, either version 3 of the License, or\r
- * (at your option) any later version.\r
- *\r
- * This program is distributed in the hope that it will be useful,\r
- * but WITHOUT ANY WARRANTY; without even the implied warranty of\r
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\r
- * GNU General Public License for more details.\r
- *\r
- * You should have received a copy of the GNU General Public License\r
- * along with this program.  If not, see <http://www.gnu.org/licenses/>.\r
- */\r
-package org.mxchange.addressbook.database.backend.csv;\r
-\r
-import java.io.DataOutput;\r
-import java.io.FileNotFoundException;\r
-import java.io.IOException;\r
-import java.io.RandomAccessFile;\r
-import java.text.MessageFormat;\r
-import java.util.ArrayList;\r
-import java.util.Iterator;\r
-import java.util.List;\r
-import java.util.StringTokenizer;\r
-import org.mxchange.addressbook.BadTokenException;\r
-import org.mxchange.addressbook.contact.Contact;\r
-import org.mxchange.addressbook.contact.book.BookContact;\r
-import org.mxchange.addressbook.contact.user.UserContact;\r
-import org.mxchange.addressbook.database.backend.BaseDatabaseBackend;\r
-import org.mxchange.addressbook.database.storage.Storeable;\r
-import org.mxchange.addressbook.database.storage.csv.StoreableCsv;\r
-\r
-/**\r
- * A database backend with CSV file as storage implementation\r
- * \r
- * @author Roland Haeder\r
- */\r
-public class CsvDatabaseBackend extends BaseDatabaseBackend implements CsvBackend {\r
-    /**\r
-     * Output stream for this storage engine\r
-     */\r
-    private RandomAccessFile storageFile;\r
-\r
-    /**\r
-     * Constructor with table name\r
-     * \r
-     * @param tableName Name of "table"\r
-     */\r
-    public CsvDatabaseBackend (final String tableName) {\r
-       // Debug message\r
-       this.getLogger().debug(MessageFormat.format("Trying to initialize table {0} ...", tableName));\r
-\r
-       // Set table name here, too\r
-       this.setTableName(tableName);\r
-\r
-       // Construct file name\r
-       String fileName = String.format("data/table_%s.csv", tableName);\r
-\r
-       // Debug message\r
-       this.getLogger().debug(MessageFormat.format("Trying to open file {0} ...", fileName));\r
-\r
-       try {\r
-           // Try to initialize the storage (file instance)\r
-           this.storageFile = new RandomAccessFile(fileName, "rw");\r
-       } catch (final FileNotFoundException ex) {\r
-           // Did not work\r
-           this.getLogger().error(MessageFormat.format("File {0} cannot be opened: {1}", fileName, ex.toString()));\r
-           System.exit(1);\r
-       }\r
-\r
-       // Output message\r
-       this.getLogger().debug(MessageFormat.format("Database for {0} has been initialized.", tableName));\r
-    }\r
-\r
-    /**\r
-     * Gets an iterator for contacts\r
-     * \r
-     * @return Iterator for contacts\r
-     * @throws org.mxchange.addressbook.BadTokenException If the underlaying method has found an invalid token\r
-     */\r
-    @Override\r
-    public Iterator<Contact> contactIterator () throws BadTokenException {\r
-       /*\r
-        * Then read the file into RAM (yes, not perfect for >1000 entries ...)\r
-        * and get a List back.\r
-        */\r
-       List<Contact> list = this.readContactList();\r
-\r
-       // Get iterator from list and return it\r
-       return list.iterator();\r
-    }\r
-\r
-    /**\r
-     * Shuts down this backend\r
-     */\r
-    @Override\r
-    public void doShutdown () {\r
-       try {\r
-           // Close file\r
-           this.getStorageFile().close();\r
-       } catch (final IOException ex) {\r
-           this.getLogger().catching(ex);\r
-           System.exit(1);\r
-       }\r
-    }\r
-\r
-    /**\r
-     * Get length of underlaying file\r
-     *\r
-     * @return Length of underlaying file\r
-     */\r
-    @Override\r
-    public long length () {\r
-       long length = 0;\r
-       \r
-       try {\r
-           length = this.getStorageFile().length();\r
-           this.getLogger().debug(MessageFormat.format("length={0}", length));\r
-       } catch (final IOException ex) {\r
-           // Length cannot be determined\r
-           this.getLogger().catching(ex);\r
-           System.exit(1);\r
-       }\r
-       \r
-       // Return result\r
-        this.getLogger().trace(MessageFormat.format("length={0} : EXIT!", length));\r
-       return length;\r
-    }\r
-\r
-    /**\r
-     * Rewinds backend\r
-     */\r
-    @Override\r
-    public void rewind (){\r
-        this.getLogger().trace("CALLED!");\r
-\r
-       try {\r
-           // Rewind underlaying database file\r
-           this.getStorageFile().seek(0);\r
-       } catch (final IOException ex) {\r
-           this.getLogger().catching(ex);\r
-           System.exit(1);\r
-       }\r
-\r
-       this.getLogger().trace("EXIT!");\r
-    }\r
-\r
-    /**\r
-     * Stores given object by "visiting" it\r
-     *\r
-     * @param object An object implementing Storeable\r
-     * @throws java.io.IOException From "inner" class\r
-     */\r
-    @Override\r
-    public void store (final Storeable object) throws IOException {\r
-       // Make sure the instance is there (DataOutput flawor)\r
-       assert(this.storageFile instanceof DataOutput);\r
-\r
-       // Try to cast it, this will fail if the interface is not implemented\r
-       StoreableCsv csv = (StoreableCsv) object;\r
-\r
-       // Now get a string from the object that needs to be stored\r
-       String str = csv.getCsvStringFromStoreableObject();\r
-\r
-       // Debug message\r
-       this.getLogger().debug(MessageFormat.format("str({0})={1}", str.length(), str));\r
-\r
-       // The string is now a valid CSV string\r
-       this.getStorageFile().writeBytes(str);\r
-    }\r
-\r
-    /**\r
-     * Adds given contact to list\r
-     * \r
-     * @param contact Contact instance to add\r
-     * @param list List instance\r
-     */\r
-    private void addContactToList (final Contact contact, final List<Contact> list) {\r
-       // Debug message\r
-       this.getLogger().debug(MessageFormat.format("contact={0}", contact));\r
-\r
-       // Is the contact read?\r
-       if (contact instanceof Contact) {\r
-           // Then add it\r
-           boolean added = list.add(contact);\r
-\r
-           // Debug message\r
-           this.getLogger().debug(MessageFormat.format("contact={0} added={1}", contact, added));\r
-\r
-           // Has it been added?\r
-           if (!added) {\r
-               // Not added\r
-               this.getLogger().warn("Contact object has not been added.");\r
-           }\r
-       }\r
-    }\r
-\r
-    /**\r
-     * Returns storage file\r
-     * \r
-     * @return Storage file instance\r
-     */\r
-    private RandomAccessFile getStorageFile () {\r
-       return this.storageFile;\r
-    }\r
-\r
-    /**\r
-     * Checks whether end of file has been reached\r
-     * \r
-     * @return Whether lines are left to read\r
-     */\r
-    private boolean isEndOfFile () {\r
-       // Default is EOF\r
-       boolean isEof = true;\r
-\r
-       try {\r
-           isEof = (this.getStorageFile().getFilePointer() >= this.length());\r
-       } catch (final IOException ex) {\r
-           // Length cannot be determined\r
-           this.getLogger().catching(ex);\r
-       }\r
-\r
-       // Return status\r
-       this.getLogger().trace(MessageFormat.format("isEof={0} : EXIT!", isEof));\r
-       return isEof;\r
-    }\r
-\r
-    /**\r
-     * Reads the database file, if available, and adds all read lines into\r
-     * the list.\r
-     * \r
-     * @return A list with Contact instances\r
-     */\r
-    private List<Contact> readContactList () throws BadTokenException {\r
-       this.getLogger().trace("CALLED!");\r
-\r
-       // First rewind\r
-       this.rewind();\r
-\r
-       // Get file size and divide it by 140 (possible average length of one line)\r
-       int lines = Math.round(this.length() / 140 + 0.5f);\r
-\r
-       // Debug message\r
-       this.getLogger().debug(MessageFormat.format("lines={0}", lines));\r
-\r
-       // Instance list\r
-       // @TODO The maximum length could be guessed from file size?\r
-       List<Contact> list = new ArrayList<>(lines);\r
-\r
-       // Init variables\r
-       StringTokenizer tokenizer;\r
-       String line;\r
-\r
-       // Read all lines\r
-       while (!this.isEndOfFile()) {\r
-           // Then read a line\r
-           line = this.readLine();\r
-\r
-           // Debug message\r
-           this.getLogger().debug(MessageFormat.format("line={0}", line));\r
-\r
-           // Then tokenize it\r
-           // @TODO Move this into separate method\r
-           tokenizer = new StringTokenizer(line, ";");\r
-\r
-           // Count round\r
-           int count = 0;\r
-\r
-           // Init contact object\r
-           Contact contact = null;\r
-\r
-           // The tokens are now available, so get all\r
-           while (tokenizer.hasMoreElements()) {\r
-               // Get next token\r
-               String token = tokenizer.nextToken();\r
-\r
-               // Debug message\r
-               this.getLogger().debug(MessageFormat.format("token={0}", token));\r
-\r
-               // Verify token, it must have double-quotes on each side\r
-               if ((!token.startsWith("\"")) || (!token.endsWith("\""))) {\r
-                   // Something bad was read\r
-                   throw new BadTokenException(MessageFormat.format("Token {0} has not double-quotes on both ends.", token));\r
-               }\r
-\r
-               // All fine, so remove it\r
-               String strippedToken = token.substring(1, token.length() - 1);\r
-\r
-               // Is the string's content "null"?\r
-               if (strippedToken.equals("null")) {\r
-                   // Debug message\r
-                   this.getLogger().debug(MessageFormat.format("strippedToken={0} - NULL!", strippedToken));\r
-\r
-                   // This needs to be set to null\r
-                   strippedToken = null;\r
-               }\r
-\r
-               // Debug message\r
-               this.getLogger().debug(MessageFormat.format("strippedToken={0}", strippedToken));\r
-\r
-               // Init number/string data values\r
-               String strData = strippedToken;\r
-               Long num = null;\r
-               Boolean bool = null;\r
-               char gender = '?';\r
-               \r
-               // Now, let's try a number check, if no null\r
-               if (strippedToken != null) {\r
-                   // Okay, no null, maybe the string bears a decimal number?\r
-                   try {\r
-                       num = Long.valueOf(strippedToken);\r
-\r
-                       // Debug message\r
-                       this.getLogger().debug(MessageFormat.format("strippedToken={0} - NUMBER!", strippedToken));\r
-                   } catch (final NumberFormatException ex) {\r
-                       // No number, then set default\r
-                       num = null;\r
-                   }\r
-               }\r
-               \r
-               // Now, let's try a boolean check, if no null\r
-               if ((strippedToken != null) && (num == null) && ((strippedToken.equals("true")) || (strippedToken.equals("false")))) {\r
-                   // Debug message\r
-                   this.getLogger().debug(MessageFormat.format("strippedToken={0} - BOOLEAN!", strippedToken));\r
-\r
-                   // parseBoolean() is relaxed, so no exceptions\r
-                   bool = Boolean.valueOf(strippedToken);\r
-               }\r
-               \r
-               // Now, let's try a boolean check, if no null\r
-               if ((strippedToken != null) && (num == null) && (bool == null) && ((strippedToken.equals("M")) || (strippedToken.equals("F")) || (strippedToken.equals("C")))) {\r
-                   // Get first character\r
-                   gender = strippedToken.charAt(0);\r
-               }\r
-\r
-               // Now it depends on the counter which position we need to check\r
-               switch (count) {\r
-                   case 0: // isOwnContact\r
-                       assert((bool instanceof Boolean));\r
-\r
-                       // Debug message\r
-                       this.getLogger().debug(MessageFormat.format("bool={0}", bool));\r
-\r
-                       // Is it own contact?\r
-                       if (true == bool) {\r
-                           // Debug message\r
-                           this.getLogger().debug("Creating UserContact object ...");\r
-\r
-                           // Own entry\r
-                           contact = new UserContact();\r
-                       } else {\r
-                           // Debug message\r
-                           this.getLogger().debug("Creating BookContact object ...");\r
-\r
-                           // Other contact\r
-                           contact = new BookContact();\r
-                       }\r
-                       break;\r
-\r
-                   case 1: // Gender\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-                       assert(gender != '?') : "Gender is not detected.";\r
-\r
-                       // Update data\r
-                       contact.updateNameData(gender, null, null, null);\r
-                       break;\r
-\r
-                   case 2: // Surname\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-                       assert(gender != '?') : "Gender is not detected.";\r
-\r
-                       // Update data\r
-                       contact.updateNameData(gender, strippedToken, null, null);\r
-                       break;\r
-\r
-                   case 3: // Family name\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-                       assert(gender != '?') : "Gender is not detected.";\r
-\r
-                       // Update data\r
-                       contact.updateNameData(gender, null, strippedToken, null);\r
-                       break;\r
-\r
-                   case 4: // Company name\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-                       assert(gender != '?') : "Gender is not detected.";\r
-\r
-                       // Update data\r
-                       contact.updateNameData(gender, null, null, strippedToken);\r
-                       break;\r
-\r
-                   case 5: // Street number\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-\r
-                       // Update data\r
-                       contact.updateAddressData(strippedToken, 0, null, null);\r
-                       break;\r
-\r
-                   case 6: // ZIP code\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-\r
-                       // Update data\r
-                       contact.updateAddressData(null, num, null, null);\r
-                       break;\r
-\r
-                   case 7: // City name\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-\r
-                       // Update data\r
-                       contact.updateAddressData(null, 0, strippedToken, null);\r
-                       break;\r
-\r
-                   case 8: // Country code\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-\r
-                       // Update data\r
-                       contact.updateAddressData(null, 0, null, strippedToken);\r
-                       break;\r
-\r
-                   case 9: // Phone number\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-\r
-                       // Update data\r
-                       contact.updateOtherData(strippedToken, null, null, null, null, null);\r
-                       break;\r
-\r
-                   case 10: // Fax number\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-\r
-                       // Update data\r
-                       contact.updateOtherData(null, strippedToken, null, null, null, null);\r
-                       break;\r
-\r
-                   case 11: // Cellphone number\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-\r
-                       // Update data\r
-                       contact.updateOtherData(null, null, strippedToken, null, null, null);\r
-                       break;\r
-\r
-                   case 12: // Email address\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-\r
-                       // Update data\r
-                       contact.updateOtherData(null, null, null, strippedToken, null, null);\r
-                       break;\r
-\r
-                   case 13: // Birthday\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-\r
-                       // Update data\r
-                       contact.updateOtherData(null, null, null, null, strippedToken, null);\r
-                       break;\r
-\r
-                   case 14: // Birthday\r
-                       assert(contact instanceof Contact) : "First token was not boolean";\r
-\r
-                       // Update data\r
-                       contact.updateOtherData(null, null, null, null, null, strippedToken);\r
-                       break;\r
-\r
-                   default: // New data entry\r
-                       this.getLogger().warn(MessageFormat.format("Will not handle unknown data {0} at index {1}", strippedToken, count));\r
-                       break;\r
-               }\r
-\r
-               // Increment counter for next round\r
-               count++;\r
-           }\r
-\r
-           // Add contact\r
-           this.addContactToList(contact, list);\r
-       }\r
-\r
-       // Return finished list\r
-       this.getLogger().trace(MessageFormat.format("list.size()={0} : EXIT!", list.size()));\r
-       return list;\r
-    }\r
-\r
-    /**\r
-     * Reads a line from file base\r
-     *\r
-     * @return Read line from file\r
-     */\r
-    private String readLine () {\r
-       // Init input\r
-       String input = null;\r
-\r
-       try {\r
-           input = this.getStorageFile().readLine();\r
-       } catch (final IOException ex) {\r
-           this.getLogger().catching(ex);\r
-       }\r
-\r
-       // Return read string or null\r
-       return input;\r
-    }\r
-}\r
+/*
+ * Copyright (C) 2015 Roland Haeder
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package org.mxchange.addressbook.database.backend.csv;
+
+import java.io.DataOutput;
+import java.io.FileNotFoundException;
+import java.io.IOException;
+import java.io.RandomAccessFile;
+import java.text.MessageFormat;
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.List;
+import java.util.StringTokenizer;
+import org.mxchange.addressbook.contact.Contact;
+import org.mxchange.addressbook.contact.Gender;
+import org.mxchange.addressbook.contact.book.BookContact;
+import org.mxchange.addressbook.contact.user.UserContact;
+import org.mxchange.addressbook.database.backend.BaseDatabaseBackend;
+import org.mxchange.addressbook.database.storage.Storeable;
+import org.mxchange.addressbook.database.storage.csv.StoreableCsv;
+import org.mxchange.addressbook.exceptions.BadTokenException;
+
+/**
+ * A database backend with CSV file as storage implementation
+ *
+ * @author Roland Haeder
+ */
+public class CsvDatabaseBackend extends BaseDatabaseBackend implements CsvBackend {
+
+       /**
+        * Output stream for this storage engine
+        */
+       private RandomAccessFile storageFile;
+
+       /**
+        * Constructor with table name
+        *
+        * @param tableName Name of "table"
+        */
+       public CsvDatabaseBackend (final String tableName) {
+               // Debug message
+               this.getLogger().debug(MessageFormat.format("Trying to initialize table {0} ...", tableName));
+
+               // Set table name here, too
+               this.setTableName(tableName);
+
+               // Construct file name
+               String fileName = String.format("data/table_%s.csv", tableName);
+
+               // Debug message
+               this.getLogger().debug(MessageFormat.format("Trying to open file {0} ...", fileName));
+
+               try {
+                       // Try to initialize the storage (file instance)
+                       this.storageFile = new RandomAccessFile(fileName, "rw");
+               } catch (final FileNotFoundException ex) {
+                       // Did not work
+                       this.getLogger().error(MessageFormat.format("File {0} cannot be opened: {1}", fileName, ex.toString()));
+                       System.exit(1);
+               }
+
+               // Output message
+               this.getLogger().debug(MessageFormat.format("Database for {0} has been initialized.", tableName));
+       }
+
+       /**
+        * Gets an iterator for contacts
+        *
+        * @return Iterator for contacts
+        * @throws org.mxchange.addressbook.exceptions.BadTokenException If the
+        * underlaying method has found an invalid token
+        */
+       @Override
+       public Iterator<Contact> contactIterator () throws BadTokenException {
+               /*
+                * Then read the file into RAM (yes, not perfect for >1000 entries ...)
+                * and get a List back.
+                */
+               List<Contact> list = this.readContactList();
+
+               // Get iterator from list and return it
+               return list.iterator();
+       }
+
+       /**
+        * Shuts down this backend
+        */
+       @Override
+       public void doShutdown () {
+               try {
+                       // Close file
+                       this.getStorageFile().close();
+               } catch (final IOException ex) {
+                       this.getLogger().catching(ex);
+                       System.exit(1);
+               }
+       }
+
+       /**
+        * Get length of underlaying file
+        *
+        * @return Length of underlaying file
+        */
+       @Override
+       public long length () {
+               long length = 0;
+
+               try {
+                       length = this.getStorageFile().length();
+                       this.getLogger().debug(MessageFormat.format("length={0}", length));
+               } catch (final IOException ex) {
+                       // Length cannot be determined
+                       this.getLogger().catching(ex);
+                       System.exit(1);
+               }
+
+               // Return result
+               this.getLogger().trace(MessageFormat.format("length={0} : EXIT!", length));
+               return length;
+       }
+
+       /**
+        * Rewinds backend
+        */
+       @Override
+       public void rewind () {
+               this.getLogger().trace("CALLED!");
+
+               try {
+                       // Rewind underlaying database file
+                       this.getStorageFile().seek(0);
+               } catch (final IOException ex) {
+                       this.getLogger().catching(ex);
+                       System.exit(1);
+               }
+
+               this.getLogger().trace("EXIT!");
+       }
+
+       /**
+        * Stores given object by "visiting" it
+        *
+        * @param object An object implementing Storeable
+        * @throws java.io.IOException From "inner" class
+        */
+       @Override
+       public void store (final Storeable object) throws IOException {
+               // Make sure the instance is there (DataOutput flawor)
+               assert (this.storageFile instanceof DataOutput);
+
+               // Try to cast it, this will fail if the interface is not implemented
+               StoreableCsv csv = (StoreableCsv) object;
+
+               // Now get a string from the object that needs to be stored
+               String str = csv.getCsvStringFromStoreableObject();
+
+               // Debug message
+               this.getLogger().debug(MessageFormat.format("str({0})={1}", str.length(), str));
+
+               // The string is now a valid CSV string
+               this.getStorageFile().writeBytes(str);
+       }
+
+       /**
+        * Adds given contact to list
+        *
+        * @param contact Contact instance to add
+        * @param list List instance
+        */
+       private void addContactToList (final Contact contact, final List<Contact> list) {
+               // Debug message
+               this.getLogger().debug(MessageFormat.format("contact={0}", contact));
+
+               // Is the contact read?
+               if (contact instanceof Contact) {
+                       // Then add it
+                       boolean added = list.add(contact);
+
+                       // Debug message
+                       this.getLogger().debug(MessageFormat.format("contact={0} added={1}", contact, added));
+
+                       // Has it been added?
+                       if (!added) {
+                               // Not added
+                               this.getLogger().warn("Contact object has not been added.");
+                       }
+               }
+       }
+
+       /**
+        * Returns storage file
+        *
+        * @return Storage file instance
+        */
+       private RandomAccessFile getStorageFile () {
+               return this.storageFile;
+       }
+
+       /**
+        * Checks whether end of file has been reached
+        *
+        * @return Whether lines are left to read
+        */
+       private boolean isEndOfFile () {
+               // Default is EOF
+               boolean isEof = true;
+
+               try {
+                       isEof = (this.getStorageFile().getFilePointer() >= this.length());
+               } catch (final IOException ex) {
+                       // Length cannot be determined
+                       this.getLogger().catching(ex);
+               }
+
+               // Return status
+               this.getLogger().trace(MessageFormat.format("isEof={0} : EXIT!", isEof));
+               return isEof;
+       }
+
+       /**
+        * Reads the database file, if available, and adds all read lines into the
+        * list.
+        *
+        * @return A list with Contact instances
+        */
+       private List<Contact> readContactList () throws BadTokenException {
+               this.getLogger().trace("CALLED!");
+
+               // First rewind
+               this.rewind();
+
+               // Get file size and divide it by 140 (possible average length of one line)
+               int lines = Math.round(this.length() / 140 + 0.5f);
+
+               // Debug message
+               this.getLogger().debug(MessageFormat.format("lines={0}", lines));
+
+       // Instance list
+               // @TODO The maximum length could be guessed from file size?
+               List<Contact> list = new ArrayList<>(lines);
+
+               // Init variables
+               StringTokenizer tokenizer;
+               String line;
+
+               // Read all lines
+               while (!this.isEndOfFile()) {
+                       // Then read a line
+                       line = this.readLine();
+
+                       // Debug message
+                       this.getLogger().debug(MessageFormat.format("line={0}", line));
+
+           // Then tokenize it
+                       // @TODO Move this into separate method
+                       tokenizer = new StringTokenizer(line, ";");
+
+                       // Count round
+                       int count = 0;
+
+                       // Init contact object
+                       Contact contact = null;
+
+                       // The tokens are now available, so get all
+                       while (tokenizer.hasMoreElements()) {
+                               // Get next token
+                               String token = tokenizer.nextToken();
+
+                               // Debug message
+                               this.getLogger().debug(MessageFormat.format("token={0}", token));
+
+                               // Verify token, it must have double-quotes on each side
+                               if ((!token.startsWith("\"")) || (!token.endsWith("\""))) {
+                                       // Something bad was read
+                                       throw new BadTokenException(MessageFormat.format("Token {0} has not double-quotes on both ends.", token));
+                               }
+
+                               // All fine, so remove it
+                               String strippedToken = token.substring(1, token.length() - 1);
+
+                               // Is the string's content "null"?
+                               if (strippedToken.equals("null")) {
+                                       // Debug message
+                                       this.getLogger().debug(MessageFormat.format("strippedToken={0} - NULL!", strippedToken));
+
+                                       // This needs to be set to null
+                                       strippedToken = null;
+                               }
+
+                               // Debug message
+                               this.getLogger().debug(MessageFormat.format("strippedToken={0}", strippedToken));
+
+                               // Init number/string data values
+                               String strData = strippedToken;
+                               Long num = null;
+                               Boolean bool = null;
+                               Gender gender = null;
+
+                               // Now, let's try a number check, if no null
+                               if (strippedToken != null) {
+                                       // Okay, no null, maybe the string bears a decimal number?
+                                       try {
+                                               num = Long.valueOf(strippedToken);
+
+                                               // Debug message
+                                               this.getLogger().debug(MessageFormat.format("strippedToken={0} - NUMBER!", strippedToken));
+                                       } catch (final NumberFormatException ex) {
+                                               // No number, then set default
+                                               num = null;
+                                       }
+                               }
+
+                               // Now, let's try a boolean check, if no null
+                               if ((strippedToken != null) && (num == null) && ((strippedToken.equals("true")) || (strippedToken.equals("false")))) {
+                                       // Debug message
+                                       this.getLogger().debug(MessageFormat.format("strippedToken={0} - BOOLEAN!", strippedToken));
+
+                                       // parseBoolean() is relaxed, so no exceptions
+                                       bool = Boolean.valueOf(strippedToken);
+                               }
+
+                               // Now, let's try a boolean check, if no null
+                               if ((strippedToken != null) && (num == null) && (bool == null) && ((strippedToken.equals("M")) || (strippedToken.equals("F")) || (strippedToken.equals("C")))) {
+                                       // Get first character
+                                       gender = Gender.fromChar(strippedToken.charAt(0));
+                               }
+
+                               // Now it depends on the counter which position we need to check
+                               switch (count) {
+                                       case 0: // isOwnContact
+                                               assert ((bool instanceof Boolean));
+
+                                               // Debug message
+                                               this.getLogger().debug(MessageFormat.format("bool={0}", bool));
+
+                                               // Is it own contact?
+                                               if (true == bool) {
+                                                       // Debug message
+                                                       this.getLogger().debug("Creating UserContact object ...");
+
+                                                       // Own entry
+                                                       contact = new UserContact();
+                                               } else {
+                                                       // Debug message
+                                                       this.getLogger().debug("Creating BookContact object ...");
+
+                                                       // Other contact
+                                                       contact = new BookContact();
+                                               }
+                                               break;
+
+                                       case 1: // Gender
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateNameData(gender, null, null, null);
+                                               break;
+
+                                       case 2: // Surname
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateNameData(gender, strippedToken, null, null);
+                                               break;
+
+                                       case 3: // Family name
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateNameData(gender, null, strippedToken, null);
+                                               break;
+
+                                       case 4: // Company name
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateNameData(gender, null, null, strippedToken);
+                                               break;
+
+                                       case 5: // Street number
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateAddressData(strippedToken, 0, null, null);
+                                               break;
+
+                                       case 6: // ZIP code
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateAddressData(null, num, null, null);
+                                               break;
+
+                                       case 7: // City name
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateAddressData(null, 0, strippedToken, null);
+                                               break;
+
+                                       case 8: // Country code
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateAddressData(null, 0, null, strippedToken);
+                                               break;
+
+                                       case 9: // Phone number
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateOtherData(strippedToken, null, null, null, null, null);
+                                               break;
+
+                                       case 10: // Fax number
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateOtherData(null, strippedToken, null, null, null, null);
+                                               break;
+
+                                       case 11: // Cellphone number
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateOtherData(null, null, strippedToken, null, null, null);
+                                               break;
+
+                                       case 12: // Email address
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateOtherData(null, null, null, strippedToken, null, null);
+                                               break;
+
+                                       case 13: // Birthday
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateOtherData(null, null, null, null, strippedToken, null);
+                                               break;
+
+                                       case 14: // Birthday
+                                               assert (contact instanceof Contact) : "First token was not boolean";
+
+                                               // Update data
+                                               contact.updateOtherData(null, null, null, null, null, strippedToken);
+                                               break;
+
+                                       default: // New data entry
+                                               this.getLogger().warn(MessageFormat.format("Will not handle unknown data {0} at index {1}", strippedToken, count));
+                                               break;
+                               }
+
+                               // Increment counter for next round
+                               count++;
+                       }
+
+                       // Add contact
+                       this.addContactToList(contact, list);
+               }
+
+               // Return finished list
+               this.getLogger().trace(MessageFormat.format("list.size()={0} : EXIT!", list.size()));
+               return list;
+       }
+
+       /**
+        * Reads a line from file base
+        *
+        * @return Read line from file
+        */
+       private String readLine () {
+               // Init input
+               String input = null;
+
+               try {
+                       input = this.getStorageFile().readLine();
+               } catch (final IOException ex) {
+                       this.getLogger().catching(ex);
+               }
+
+               // Return read string or null
+               return input;
+       }
+}