]> git.mxchange.org Git - jbonuscard-lib.git/blobdiff - Addressbook/src/org/mxchange/addressbook/database/backend/csv/CsvDatabaseBackend.java
Moved exceptions in own package
[jbonuscard-lib.git] / Addressbook / src / org / mxchange / addressbook / database / backend / csv / CsvDatabaseBackend.java
index 750d60ec2a5ed511f5260a4bd649ea34de9537c7..7540254ee2c7c193ecea5265600d76f2e22aff04 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
-     * 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.storageFile.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.storageFile.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.storageFile.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
-     * 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.storageFile.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.storageFile.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.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;
+               char gender = '?';
+               
+               // 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 = 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";
+                       assert(gender != '?') : "Gender is not detected.";
+
+                       // Update data
+                       contact.updateNameData(gender, null, null, null);
+                       break;
+
+                   case 2: // Surname
+                       assert(contact instanceof Contact) : "First token was not boolean";
+                       assert(gender != '?') : "Gender is not detected.";
+
+                       // Update data
+                       contact.updateNameData(gender, strippedToken, null, null);
+                       break;
+
+                   case 3: // Family name
+                       assert(contact instanceof Contact) : "First token was not boolean";
+                       assert(gender != '?') : "Gender is not detected.";
+
+                       // Update data
+                       contact.updateNameData(gender, null, strippedToken, null);
+                       break;
+
+                   case 4: // Company name
+                       assert(contact instanceof Contact) : "First token was not boolean";
+                       assert(gender != '?') : "Gender is not detected.";
+
+                       // 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;
+    }
+}