Wie im ersten Beispiel gezeigt kann ein Fremdschl\u00fcssel in einer Bestellung die zum Kunden verweist wie folgt definiert werden:<\/p>\n
\/**\n * The foreign key field 'fkField' refers to {@link #customer},\n * it will be set via {@link #setCustomer(Customer)}.\n *\/\n@SeifeField(foreignKey = @ForeignkeyDef(fkField = \"customer\", refKeyField=\"id\", refClass=Customer.class))\nprivate Long customerId;\n\nprivate Customer customer;<\/pre>\nDas Attribut foreignKey = @ForeignkeyDef( \/* .. *\/ )<\/code> definiert die Eigenschaft der Tabellenreferenz.<\/p>\n\nfkField<\/code>
\nbezeichnet den Namen des Feldes zur Instanzreferenz private Customer customer das der generierte Code nutzt wenn die Referenz aufgel\u00f6st wird<\/li>\nrefKeyField<\/code>
\nbezeichnet den Prim\u00e4rschl\u00fcsselteil auf das dieses Feld referenziert, der Datentyp muss \u00fcbereinstimmen<\/li>\nrefClass<\/code>
\ndefiniert den Typ der Instanzreferenz<\/li>\n<\/ul>\nDer Mechanismus ist so einfach wie m\u00f6glich gehalten. Es ist keine zus\u00e4tzliche Bibliothek als Zwischenschicht erforderlich und es werden keine generischen Datentypen oder spezielle Collections benutzt.
\nEs wird einfacher Android Quelltext basierend auf Vorlagen generiert, der leicht zu lesen ist da die Fremdschl\u00fcssel-Definitionen \u00e4hnlich und selbsterkl\u00e4rend sind.<\/p>\n
Der generierte SchemaPeer hat die korrekten SQL foreign-key Referenzen definiert, jedoch wird nicht automatisch ein Index dazu erzeugt. (Siehe dazu SQLite documentation<\/a> oder z.B. diese Frage auf StackOverflow<\/a>)<\/p>\n\/**\n * Table creation script\n *\/\nprivate static final String SQL_CREATE_TABLE_ORDER =\n \"create table \" + TBL_ORDER + \" (\" + \n COL_ID + \" integer primary key autoincrement,\" +\n COL_FK_CUSTOMER_CUSTOMER_ID + \" integer,\" +\n COL_ORDER_DATE + \" integer not null\" +\n \", \" +\n \" FOREIGN KEY(\" + COL_FK_CUSTOMER_CUSTOMER_ID + \")\" +\n \" REFERENCES \" + CustomerSchema.TBL_CUSTOMER \n +\"(\" + CustomerSchema.COL_ID + \")\" +\t\t\t \t\t\n \")\";\n<\/pre>\nReferenzierung von zusammengesetzten Prim\u00e4rschl\u00fcsseln<\/h4>\n
Wenn der Fremdschl\u00fcssel auf ein eindeutiges Tuple von Spalten verweist, also technisch korrekt ist, so kann es auch modelliert werden. Dazu werden alle technischen Schl\u00fcsselteile in fkField mit dem gleichen Instanznamen konfiguriert.
\nDie folgende Klasse ‘Language’ hat einen zusammengesetzten Prim\u00e4rschl\u00fcssel bestehend aus Land und Sprache<\/p>\n
@SeifeClass(sqlTablename=\"locale\", version=2, generatorOptions={GeneratorOption.BOCLASS, GeneratorOption.SCHEMA_PEER})\npublic class Language {\n\n @SeifeField(isPrimaryKey=true, sqlOptions=@SqlFieldOptions(sqlAutoIncrement=false, sqlColumn=\"_country\"))\n private String countryId;\n @SeifeField(isPrimaryKey=true, sqlOptions=@SqlFieldOptions(sqlAutoIncrement=false, sqlColumn=\"_language\"))\n private String languageId;\n\n \/\/ ..\n}<\/pre>\nDer Fremdschl\u00fcssel wird dann wie unten defniniert, jeweils ein technisches Feld f\u00fcr die Referenzen und ein Instanzfeld “Language” auf das beides Mal in fkField eingetragen wird. Diesesmal wird wie oben schon erw\u00e4hnt auch ein Index ‘locale’ erstellt.<\/p>\n
@SeifeClass(generatorOptions={GeneratorOption.BOCLASS_PARCELABLE, GeneratorOption.SCHEMA_PEER, GeneratorOption.DB_HELPER+\"=LocaleOpenHelper\", \n GeneratorOption.DATA_PROVIDER+\"=LocaleProvider\"})\npublic class LocaleData {\n\n private Language language;\n\n @SeifeField(\n foreignKey = @ForeignkeyDef(fkField=\"language\", refKeyField=\"countryId\", refClass=Language.class),\n sqlOptions=@SqlFieldOptions(sqlIndex=\"locale\"))\n private String countryId;\n \n @SeifeField(\n foreignKey = @ForeignkeyDef(fkField=\"language\", refKeyField=\"languageId\", refClass=Language.class),\n sqlOptions=@SqlFieldOptions(sqlIndex=\"locale\"))\n private String languageId;\n \n @Id\n @GeneratedValue(strategy=GenerationType.AUTO)\n @SeifeField(isPrimaryKey=true, sqlOptions=@SqlFieldOptions(sqlColumn=\"_id\"))\n private int id;\n \/\/ ..\n}<\/pre>\nDas erzeugte Skript f\u00fcr die Tabelle im LocaleOpenHelper enth\u00e4lt dann die definierte Fremdschl\u00fcsselreferenz und es existiert eine SQL-Index Definition.<\/p>\n
private static final String SQL_CREATE_TABLE_LOCALE_DATA =\n \"create table \" + TBL_LOCALE_DATA + \" (\" + \n COL_ID + \" integer primary key autoincrement,\" +\n COL_FK_LANGUAGE_COUNTRY_ID + \" text,\" +\n COL_FK_LANGUAGE_LANGUAGE_ID + \" text\" +\n \", \" +\n \" FOREIGN KEY(\" + COL_FK_LANGUAGE_COUNTRY_ID + \",\" + COL_FK_LANGUAGE_LANGUAGE_ID + \")\" +\n \" REFERENCES \" + LanguageSchema.TBL_LANGUAGE \n +\"(\" + LanguageSchema.COL_COUNTRY_ID + \",\" + LanguageSchema.COL_LANGUAGE_ID + \")\" +\t\t\t \t\t\n \")\";\n\n \/**\n * Index for locale\n *\/\n public static final String SQL_CREATE_IDX_LOCALE_DATA_LOCALE = \n \"create index if not exists \"\n + TBL_LOCALE_DATA\n + \"_idx_locale ON \" + TBL_LOCALE_DATA\n + \"(\" + COL_FK_LANGUAGE_COUNTRY_ID + \",\" + COL_FK_LANGUAGE_LANGUAGE_ID + \")\";\n<\/pre>\nVersionierung<\/h4>\n
Wie im Abschnitt zur Versionierung von Tabellen beschrieben, werden auch der Fremdschl\u00fcssel und der Tabellenindex in der Upgrade Logik mit ber\u00fccksichtigt. Im Beispiel ist der Foreign Key in Version 2 hinzugekommen;<\/p>\n
private Language language;\n\n@SeifeField(\n foreignKey = @ForeignkeyDef(fkField=\"language\", refKeyField=\"countryId\", refClass=Language.class),\n sqlOptions=@SqlFieldOptions(sqlIndex=\"locale\"), version=2)\nprivate String countryId;\n\n@SeifeField(\n foreignKey = @ForeignkeyDef(fkField=\"language\", refKeyField=\"languageId\", refClass=Language.class),\n sqlOptions=@SqlFieldOptions(sqlIndex=\"locale\"), version=2)\nprivate String languageId;\n<\/pre>\nDer Programmteil wird dann neben der Erstellung der neuen Spalten auch das SQL_CREATE_IDX_LOCALE_DATA_LOCALE script ausf\u00fchren.<\/p>\n
if (oldVersion < 2 && newVersion >= 2) { \n db.execSQL(\"ALTER TABLE \" + LocaleDataSchema.TBL_LOCALE_DATA + \" ADD COLUMN \" + LocaleDataSchema.COL_FK_LANGUAGE_COUNTRY_ID + \" text\");\n db.execSQL(\"ALTER TABLE \" + LocaleDataSchema.TBL_LOCALE_DATA + \" ADD COLUMN \" + LocaleDataSchema.COL_FK_LANGUAGE_LANGUAGE_ID + \" text\");\n db.execSQL(LocaleDataSchema.SQL_CREATE_IDX_LOCALE_DATA_LOCALE);\n}\n<\/pre>\n <\/p>\n","protected":false},"excerpt":{"rendered":"
Wie im ersten Beispiel gezeigt kann ein Fremdschl\u00fcssel in einer Bestellung die zum Kunden verweist wie folgt definiert werden: \/** * The foreign key field ‘fkField’ refers to {@link #customer}, * it will be set via {@link #setCustomer(Customer)}. *\/ @SeifeField(foreignKey = @ForeignkeyDef(fkField = “customer”, refKeyField=”id”, refClass=Customer.class)) private Long customerId; private Customer customer; Das Attribut foreignKey = …<\/p>\n