/usr/share/GNUstep/Documentation/GDL2Intro/index.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- (C)

Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided also that
the entire resulting derived work is distributed under the terms of a
permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions. -->
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Top (GNUstep Database Library Introduction 0.1)</title>

<meta name="description" content="Top (GNUstep Database Library Introduction 0.1)">
<meta name="keywords" content="Top (GNUstep Database Library Introduction 0.1)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="#Top" rel="start" title="Top">
<link href="Index.html#Index" rel="index" title="Index">
<link href="#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Concepts.html#Concepts" rel="next" title="Concepts">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<h1 class="settitle" align="center">GNUstep Database Library Introduction 0.1</h1>




     
<a name="SEC_Contents"></a>
<h2 class="contents-heading">Table of Contents</h2>

<div class="contents">

<ul class="no-bullet">
  <li><a name="toc-Introduction" href="#Introduction">1 Introduction</a></li>
  <li><a name="toc-Concepts-1" href="Concepts.html#Concepts">2 Concepts</a></li>
  <li><a name="toc-Key-Value-Coding-1" href="Key-Value-Coding.html#Key-Value-Coding">3 Key Value Coding</a></li>
  <li><a name="toc-Setting-values-through-KVC" href="Key-Value-Coding.html#Setting-values-through-KVC">4 Setting values through KVC</a></li>
  <li><a name="toc-Accessing-values-through-KVC" href="Key-Value-Coding.html#Accessing-values-through-KVC">5 Accessing values through KVC</a></li>
  <li><a name="toc-Key-Paths" href="Key-Value-Coding.html#Key-Paths">6 Key Paths</a></li>
  <li><a name="toc-Type-promotion" href="Key-Value-Coding.html#Type-promotion">7 Type promotion</a></li>
  <li><a name="toc-Class-specific-implementation" href="Key-Value-Coding.html#Class-specific-implementation">8 Class specific implementation</a></li>
  <li><a name="toc-Classes-1" href="Classes.html#Classes">9 Classes</a></li>
  <li><a name="toc-Model-classes" href="Classes.html#Model-classes">10 Model classes</a></li>
  <li><a name="toc-Database-specific-classes" href="Classes.html#Database-specific-classes">11 Database specific classes</a></li>
  <li><a name="toc-Data-oriented-classes" href="Classes.html#Data-oriented-classes">12 Data oriented classes</a></li>
  <li><a name="toc-EOModel-class-1" href="EOModel-class.html#EOModel-class">13 EOModel class</a>
  <ul class="no-bullet">
    <li><a name="toc-overview" href="EOModel-class.html#overview">13.1 overview</a></li>
  </ul></li>
  <li><a name="toc-EOEntity-class-1" href="EOEntity-class.html#EOEntity-class">14 EOEntity class</a>
  <ul class="no-bullet">
    <li><a name="toc-overview-1" href="EOEntity-class.html#overview-1">14.1 overview</a></li>
    <li><a name="toc-Class-properties" href="EOEntity-class.html#Class-properties">14.2 Class properties</a></li>
    <li><a name="toc-Class-name" href="EOEntity-class.html#Class-name">14.3 Class name</a></li>
    <li><a name="toc-Primary-Key-Attributes" href="EOEntity-class.html#Primary-Key-Attributes">14.4 Primary Key Attributes</a></li>
    <li><a name="toc-External-name" href="EOEntity-class.html#External-name">14.5 External name</a></li>
  </ul></li>
  <li><a name="toc-EOAttribute-class-1" href="EOAttribute-class.html#EOAttribute-class">15 EOAttribute class</a>
  <ul class="no-bullet">
    <li><a name="toc-overview-2" href="EOAttribute-class.html#overview-2">15.1 overview</a></li>
    <li><a name="toc-Name" href="EOAttribute-class.html#Name">15.2 Name</a></li>
    <li><a name="toc-Column-name" href="EOAttribute-class.html#Column-name">15.3 Column name</a></li>
    <li><a name="toc-Adaptor-value-type" href="EOAttribute-class.html#Adaptor-value-type">15.4 Adaptor value type</a></li>
    <li><a name="toc-External-type" href="EOAttribute-class.html#External-type">15.5 External type</a></li>
    <li><a name="toc-Value-type" href="EOAttribute-class.html#Value-type">15.6 Value type</a></li>
    <li><a name="toc-Value-class-name" href="EOAttribute-class.html#Value-class-name">15.7 Value class name</a></li>
    <li><a name="toc-Value-factory-method-name" href="EOAttribute-class.html#Value-factory-method-name">15.8 Value factory method name</a></li>
    <li><a name="toc-Value-factory-argument-type" href="EOAttribute-class.html#Value-factory-argument-type">15.9 Value factory argument type</a></li>
  </ul></li>
  <li><a name="toc-EORelationship-class-1" href="EORelationship-class.html#EORelationship-class">16 EORelationship class</a>
  <ul class="no-bullet">
    <li><a name="toc-overview-3" href="EORelationship-class.html#overview-3">16.1 overview</a></li>
  </ul></li>
  <li><a name="toc-EOModelGroup-class-1" href="EOModelGroup-class.html#EOModelGroup-class">17 EOModelGroup class</a>
  <ul class="no-bullet">
    <li><a name="toc-overview-4" href="EOModelGroup-class.html#overview-4">17.1 overview</a></li>
  </ul></li>
  <li><a name="toc-EOAdaptor-class-1" href="EOAdaptor-class.html#EOAdaptor-class">18 EOAdaptor class</a>
  <ul class="no-bullet">
    <li><a name="toc-overview-5" href="EOAdaptor-class.html#overview-5">18.1 overview</a></li>
  </ul></li>
  <li><a name="toc-EOAdaptorContext-class-1" href="EOAdaptorContext-class.html#EOAdaptorContext-class">19 EOAdaptorContext class</a></li>
  <li><a name="toc-EOAdaptorChannel-class-1" href="EOAdaptorChannel-class.html#EOAdaptorChannel-class">20 EOAdaptorChannel class</a></li>
  <li><a name="toc-EODataSource-class-1" href="EODataSource-class.html#EODataSource-class">21 EODataSource class</a>
  <ul class="no-bullet">
    <li><a name="toc-overview-6" href="EODataSource-class.html#overview-6">21.1 overview</a></li>
    <li><a name="toc-Fetch-objects" href="EODataSource-class.html#Fetch-objects">21.2 Fetch objects</a></li>
    <li><a name="toc-Creating-objects" href="EODataSource-class.html#Creating-objects">21.3 Creating objects</a></li>
    <li><a name="toc-Inserting-objects" href="EODataSource-class.html#Inserting-objects">21.4 Inserting objects</a></li>
    <li><a name="toc-Deleting-objects" href="EODataSource-class.html#Deleting-objects">21.5 Deleting objects</a></li>
    <li><a name="toc-Qualified-DataSources" href="EODataSource-class.html#Qualified-DataSources">21.6 Qualified DataSources</a></li>
    <li><a name="toc-EODatabaseDataSource-class" href="EODataSource-class.html#EODatabaseDataSource-class">21.7 EODatabaseDataSource class</a></li>
  </ul></li>
  <li><a name="toc-EOEditingContext-class-1" href="EOEditingContext-class.html#EOEditingContext-class">22 EOEditingContext class</a>
  <ul class="no-bullet">
    <li><a name="toc-overview-7" href="EOEditingContext-class.html#overview-7">22.1 overview</a></li>
  </ul></li>
  <li><a name="toc-EOGenericRecord-class-1" href="EOGenericRecord-class.html#EOGenericRecord-class">23 EOGenericRecord class</a>
  <ul class="no-bullet">
    <li><a name="toc-overview-8" href="EOGenericRecord-class.html#overview-8">23.1 overview</a></li>
  </ul></li>
  <li><a name="toc-Model-Creation" href="Model-creation.html#Model-creation">24 Model Creation</a>
  <ul class="no-bullet">
    <li><a name="toc-Example-model-file-1" href="Example-model-file.html#Example-model-file">24.1 Example model file</a></li>
    <li><a name="toc-Creating-with-DBModeler-1" href="Creating-with-DBModeler.html#Creating-with-DBModeler">24.2 Creating with DBModeler</a></li>
  </ul></li>
  <li><a name="toc-Creating-a-project_002e" href="Project-creation.html#Project-creation">25 Creating a project.</a>
  <ul class="no-bullet">
    <li><a name="toc-Creating-a-makefile" href="Project-creation.html#Creating-a-makefile">25.1 Creating a makefile</a></li>
    <li><a name="toc-Adding-Resource-Files" href="Project-creation.html#Adding-Resource-Files">25.2 Adding Resource Files</a></li>
    <li><a name="toc-A-complete-GNUmakefile" href="Project-creation.html#A-complete-GNUmakefile">25.3 A complete GNUmakefile</a></li>
  </ul></li>
  <li><a name="toc-Database-creation-1" href="Database-creation.html#Database-creation">26 Database creation</a>
  <ul class="no-bullet">
    <li><a name="toc-Creating-the-database-with-DBModeler" href="Database-creation.html#Creating-the-database-with-DBModeler">26.1 Creating the database with DBModeler</a></li>
  </ul></li>
  <li><a name="toc-Database-connection-1" href="Database-connection.html#Database-connection">27 Database connection</a></li>
  <li><a name="toc-Working-with-data-1" href="Working-with-data.html#Working-with-data">28 Working with data</a></li>
  <li><a name="toc-Adding-some-data_002e" href="Working-with-data.html#Adding-some-data_002e">29 Adding some data.</a></li>
  <li><a name="toc-Working-with-relationships" href="Working-with-data.html#Working-with-relationships">30 Working with relationships</a></li>
  <li><a name="toc-EOInterface-1" href="EOInterface.html#EOInterface">31 EOInterface</a></li>
  <li><a name="toc-Introduction-1" href="EOInterface.html#Introduction-1">32 Introduction</a></li>
  <li><a name="toc-EODisplayGroup-class" href="EOInterface.html#EODisplayGroup-class">33 EODisplayGroup class</a></li>
  <li><a name="toc-EOAssociation-class" href="EOInterface.html#EOAssociation-class">34 EOAssociation class</a></li>
  <li><a name="toc-Index-1" href="Index.html#Index">Index</a></li>
</ul>
</div>

     
<a name="Top"></a>
<div class="header">
<p>
Next: <a href="Concepts.html#Concepts" accesskey="n" rel="next">Concepts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="GNUstep-Database-Library"></a>
<h1 class="top">GNUstep Database Library</h1>
<p>&copy;
</p>
<p>Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.
</p>
<p>Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided also that
the entire resulting derived work is distributed under the terms of a
permission notice identical to this one.
</p>
<p>Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions.
</p>

<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="Concepts.html#Concepts" accesskey="1">Concepts</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Key-Value-Coding.html#Key-Value-Coding" accesskey="2">Key Value Coding</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Classes.html#Classes" accesskey="3">Classes</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EOModel-class.html#EOModel-class" accesskey="4">EOModel class</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EOEntity-class.html#EOEntity-class" accesskey="5">EOEntity class</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EOAttribute-class.html#EOAttribute-class" accesskey="6">EOAttribute class</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EORelationship-class.html#EORelationship-class" accesskey="7">EORelationship class</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EOModelGroup-class.html#EOModelGroup-class" accesskey="8">EOModelGroup class</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EOAdaptor-class.html#EOAdaptor-class" accesskey="9">EOAdaptor class</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EOAdaptorContext-class.html#EOAdaptorContext-class">EOAdaptorContext class</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EOAdaptorChannel-class.html#EOAdaptorChannel-class">EOAdaptorChannel class</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EODataSource-class.html#EODataSource-class">EODataSource class</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EOEditingContext-class.html#EOEditingContext-class">EOEditingContext class</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EOGenericRecord-class.html#EOGenericRecord-class">EOGenericRecord class</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Model-creation.html#Model-creation">Model creation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Project-creation.html#Project-creation">Project creation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Database-creation.html#Database-creation">Database creation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Database-connection.html#Database-connection">Database connection</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Working-with-data.html#Working-with-data">Working with data</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EOInterface.html#EOInterface">EOInterface</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Index.html#Index">Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<a name="Introduction"></a>
<h2 class="chapter">1 Introduction</h2>
<p>This document is intended to get people started developing with GDL2.
A knowledge of objective-c and relational database concepts is assumed.
</p>
<p>While not intended as a thorough reference or a replacement for the API docs
and surely omits details for the sake of simplicity it attempts to
provide a starting point for people unfamiliar with GDL2 or EOF
to get started developing their first application.
</p>
<p>If you are reading this document from the GDL2 Sources, most example sources 
are provided in the ../../Examples/ directory.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="Concepts.html#Concepts" accesskey="1">Concepts</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Important concepts 
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Classes.html#Classes" accesskey="2">Classes</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">A basic overview of important classes to know and understand.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Model-creation.html#Model-creation" accesskey="3">Model creation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Describes different ways to create model files. 
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Project-creation.html#Project-creation" accesskey="4">Project creation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Creating a GDL2 project.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Database-creation.html#Database-creation" accesskey="5">Database creation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Creating the database on the database server.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Database-connection.html#Database-connection" accesskey="6">Database connection</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Connecting to a database through an adaptor.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Working-with-data.html#Working-with-data" accesskey="7">Working with data</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Creating, Fetching, and updating data in the database. 
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="EOInterface.html#EOInterface" accesskey="8">EOInterface</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Developing graphical applications with EOInterface.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="Index.html#Index" accesskey="9">Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Complete index.
</td></tr>
</table>


<hr>
<div class="header">
<p>
Next: <a href="Concepts.html#Concepts" accesskey="n" rel="next">Concepts</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
gnustep-dl2 0.12.0-15.1build2 / usr / share / GNUstep / Documentation / GDL2Intro / index.html
