GNUstepWiki - User contributions [en]

GNUstepWeb

2017-12-29T16:50:40Z

Dwetzel:

{{Framework|
shortdescription = GNUstepWeb is a web application library |

currentversion = [http://gnustep.org] |

releasedate = use git |

license = LGPL2|

overview = GNUstepWeb is a development framework for web applications written in Objective-C which is designed to be source-code compatible with [https://en.wikipedia.org/wiki/WebObjects WebObjects] 4.5 - a product originally developed by NeXT Inc, whose newer versions have been released by Apple and are Java-based. |

features = This library is a component of the [[GNUstep]] project in the dev-libs section and is available in the standard ways - such as the [https://github.com/gnustep/libs-gsweb GNUstep GitHub Repository].

David Wetzel recommends using the current version that can be obtained by executing the following [[GIT]] check out in an empty directory
git clone https://github.com/gnustep/libs-gsweb

|

maintainer = David Wetzel |

Installation tips =
* Install GNUstep core and gdl2 components
* Install Apache 2.x
* Download svn current version (see above)
* Install Apache2 / GNUstepWeb adaptor module (see GSWAdaptors/Apache/INSTAL in GNUstepWeb Tree)
* Setup Adaptor configuration (see GSWAdaptors/Apache/INSTAL)
* Build and install GNUstepWeb (see INSTALL) in GNUstepWeb Tree
* Build and install Examples/hello (see Examples/hello/INSTALL)
* Run hello
* Point your browser to: http://localhost/GSWeb/hello.gswa.

|

relatedlinks =
* Apple has [http://developer.apple.com/legacy/mac/library/documentation/LegacyTechnologies/WebObjects/WebObjects_4.5/webobjects.html#//apple_ref/doc/uid/TP40006775 legacy WebObjects 4.5 documentation] available. Find all other legacy documentation [http://developer.apple.com/legacy/mac/library/navigation/index.html here], just filter for WebObjects.
* [[Creating A Simple GSWeb Application]] is very easy. |

category = [[Category:GNUstepWeb]] [[Category:Networking_Frameworks]]
}}

GNUstepWeb

2017-09-01T00:40:53Z

Dwetzel:

{{Framework|
shortdescription = GNUstepWeb is a web application library |

currentversion = [http://gnustep.org] |

releasedate = use git |

license = LGPL2|

overview = GNUstepWeb is a development framework for web applications written in Objective-C which is designed to be source-code compatible with [http://www.apple.com/webobjects/ WebObjects] 4.5 - a product originally developed by NeXT Inc, whose newer versions have been released by Apple and are Java-based. |

features = This library is a component of the [[GNUstep]] project in the dev-libs section and is available in the standard ways - such as the [ftp://ftp.gnustep.org/pub/daily-snapshots/dev-libs.current.tar.bz2 GNUstep ftp site].

David Wetzel recommends using the current version that can be obtained by executing the following [[GIT]] check out in an empty directory
git clone https://github.com/gnustep/libs-gsweb

|

maintainer = David Wetzel |

Installation tips =
* Install GNUstep core and gdl2 components
* Install Apache 2.x
* Download svn current version (see above)
* Install Apache2 / GNUstepWeb adaptor module (see GSWAdaptors/Apache/INSTAL in GNUstepWeb Tree)
* Setup Adaptor configuration (see GSWAdaptors/Apache/INSTAL)
* Build and install GNUstepWeb (see INSTALL) in GNUstepWeb Tree
* Build and install Examples/hello (see Examples/hello/INSTALL)
* Run hello
* Point your browser to: http://localhost/GSWeb/hello.gswa.

|

relatedlinks =
* Apple has [http://developer.apple.com/legacy/mac/library/documentation/LegacyTechnologies/WebObjects/WebObjects_4.5/webobjects.html#//apple_ref/doc/uid/TP40006775 legacy WebObjects 4.5 documentation] available. Find all other legacy documentation [http://developer.apple.com/legacy/mac/library/navigation/index.html here], just filter for WebObjects.
* [[Creating A Simple GSWeb Application]] is very easy. |

category = [[Category:GNUstepWeb]] [[Category:Networking_Frameworks]]
}}

GDL FAQ

2010-06-28T00:27:38Z

Dwetzel:

[[Category:FAQ]]

=== Should I Make Foreign Key Attributes Class Properties? ===

No. If you need to access a foreign key value (because you want to display it in the user interface, for example), you should access it through the corresponding destination object.

[[Category:Database Frameworks]]

GDL

2010-06-28T00:27:14Z

Dwetzel:

GNUstep Database Library 2 (GDL2) is a set of libraries to map Objective-C objects to rows of relational database management systems (RDBMS). It aims to be compatible with Enterprise Objects Framework ([[EOF]]) as released with WebObjects 4.5 from Apple Inc and is used in conjuction with [[GNUstepWeb]].

==== Current Version: [ftp://ftp.gnustep.org/pub/gnustep/libs/gnustep-dl2-0.12.0.tar.gz 0.12.0] ====

* Released February 20, 2009

=== Features ===

GDL2 consists of the following components:

* EOControl
: The fundamental abstraction library which includes many non RDBMS related extensions such as KeyValueCoding extensions and other categories. Most importantly it contains the classes which handle the coordination of object graphs namely EOEditingContext.

* EOAccess
: This library implements the underlying mechanism to retrieve and store data in RDBMS. It defines the abstract classes like EOAdaptor which are subclassed to interface with concrete RDBMS implementations.

* EOInterface
: This library implements classes used to synchronize UI components such as NSTextFields, NSButtons and NSTableViews with the state of objects which an EOEditingContext contains.

* EOAdaptors
: This is a collection of concrete EOAdaptor projects needed to connect to specific databases. GDL2 currently supplies an Adaptor for PostgreSQL and SQLite.

* DBModeler
: GDL2 offers an alpha version of [[DBModeler]] to create and maintain .eomodel(d) files.

* EOModeler
: This framework is used by DBModeler can be used to write bundles for DBModeler to interface with the application.

* GDL2Palette
: Both Gorm and InterfaceBuilder can be used to create nib files which contain display groups an EOEditingContext. The palette provides those applications with the necessary code to hook up UI components with the model objects.

* Examples/Trading
: The Trading framework, provides an example model, and some routines to create a database from the model, and populate the database with data, while not an example itself it is intended for use by example applications using GDL2 alone, EOInterface or GSWeb, and for higher level tests.

* Using GDL2 in other Projects

: Typically you would want to use EOControl and EOAccess for tools and
EOInterface additionally for applications.

:: Tools:
<pre>
ADDITIONAL_NATIVE_LIBS += EOControl EOAccess
</pre>
:: Applications:
<pre>
ADDITIONAL_NATIVE_LIBS += EOControl EOAccess EOInterface
</pre>
:: GDL2 based Palettes / DBModeler Bundles:
<pre>
ADDITIONAL_NATIVE_LIBS += EOControl EOAccess EOInterface EOModeler
</pre>

=== State ===

Currently GDL2 is meant for developers who can help test and contribute to the current code or are willing to test the interface. It is not ready for general purpose production code. Having said that, it should be mentioned that GDL2 is being used in production environments and has been much tested in those contexts.

Expect the current interface to change especially with respect to functions and methods not documented in EOF 4.5. Even the library names themselves may change.

If you identify something that you need, please let us know at or even better get copyright assignment for the FSF and post a patch.

=== Maintainer ===

* [mailto:ayers@fsfe.org David Ayers]
* [mailto:dave@turbocat.de David Wetzel]
* [mailto:ratmice@gmail.com Matt Rice]

[[Category:Database Frameworks]]
[[Category:Frameworks]]

GDL FAQ

2010-06-28T00:25:51Z

Dwetzel:

GDL FAQ

2010-06-28T00:24:02Z

Dwetzel:

Should I Make Foreign Key Attributes Class Properties?

No. If you need to access a foreign key value (because you want to display it in the user interface, for example), you should access it through the corresponding destination object.

User:Dwetzel

2010-06-28T00:21:50Z

Dwetzel:

'''David Wetzel'''

'''E-mail''': dave at turbocat dot de

GSWebFAQ

2010-06-05T17:58:30Z

Dwetzel:

=== Problems with encoding ===

WO 4 uses 8-bit ISO Latin 1 encoding and WO 5 uses an 8-bit representation of Unicode characters (NSUTF8StringEncoding).
Our code uses <pre> [NSString defaultCStringEncoding]; </pre> as default. One way of changing the encoding in your application is to call

<pre>
[WOMessage setDefaultEncoding: NSUTF8StringEncoding];
</pre>

before you begin generating pages.

----

[[Category:GNUstepWeb]]
[[Category:Development]]

Platform:Linux

2010-06-01T16:54:37Z

Dwetzel: /* Install from source: Dependencies */

{{stub}}

== Debian / Ubuntu ==
=== Debian ===
Since Debian ''Sarge'' (3.1) you can use '''apt-get''' to obtain GNUstep packages.

# apt-get install x-window-system-core wmaker gnustep gnustep-devel gnustep-games

to install GNUstep, X11 and Window Maker.

The best way to get up-to-date GNUstep packages is to upgrade from ''stable'' to ''testing'' or ''unstable''. If upgrading to Debian ''unstable'' is not desirable it is possible to simply add the unstable apt lines to the sources.list and specify the distribution when installing the packages, e.g.
# apt-get install -t unstable gnumail.app
This method might upgrade some other packages to satisfy dependencies, but will have a much smaller impact on the system since only the packages on which GNUstep depends will be upgraded.

=== Ubuntu ===
As Ubuntu is Debian-based you can likewise install gnustep libraries (and their dependencies) via
sudo apt-get install gnustep gnustep-devel
apt will also suggest a lot of apps to install.

=== Install from source: Dependencies ===
If you want to compile from source install the following [[Dependencies]] packages (applies to both Debian and Ubuntu):

<tt>gobjc, libx11-dev, libx11-xft, libxmu-dev, libtiff4-dev, libpng12-dev, libungif4-dev, libart-2.0-dev, libxml2-dev, libxslt1-dev, libssl-dev, libgmp3-dev, libffcall1-dev, libcairo2-dev</tt> (universe), and <tt>svn</tt> if you want to download the svn version.

Optional: <tt>libaspell-dev</tt> for [[GSspell.service]]

Please follow the instructions on [[GNUstep_SVN_installation_guide]].

== Gentoo ==
To install GNUstep libs and scripts, do
emerge gnustep-env
For a list of GNUstep-related ebuilds, see the [http://packages.gentoo.org/search/?sstring=gnustep Online Package Database].
For the most recent packages, type <code>ACCEPT_KEYWORDS="~x86" emerge <i>package-name</i></code> (or analogically for your cpu family: <tt>"~sparc"</tt>, <tt>"~ppc"</tt> ...)

== Slackware ==

=== Version 10.2 ===
Libraries and accompanying applications will build with no modifications. Slackware 10.2 ships with GCC 3.3.6, so mixed Objective-C and C++ code is not supported, meaning additional frameworks/libraries may not be supported.

=== Version 11.0 ===
This version of Slackware works the same as the previous (10.2). Libraries and applications will build with no modifications, but due to the GCC version used (3.4.6) Objective-C++ is not supported.

=== Version 12.0 ===
GNUstep compiles and install on Slackware 12.0 perfectly. Unfortunately, this version of Slackware does not include an Objective-C++ compiler.

=== Version 12.2 ===
==== Packages ====
Slackware packages have been created and can be found in:
* [ftp://ftp.gnustep.org/pub/gnustep/binaries/slackware/ GNUstep FTP] (Please read gnustep-core.README before installing)
==== Build Scripts ====
SlackBuild scripts can be found at:
* [http://slackbuilds.org/result/?search=gnustep SlackBuilds.org GNUstep scripts]

== SuSE ==
Packages provided by Richard Stonehouse [http://www.rstonehouse.co.uk/extras/gnustep-general/index.html here] (including installation instructions).

[[Category:Development]]

GNUstepWeb

2007-12-08T13:05:19Z

Dwetzel:

{{Framework|
shortdescription = GNUstepWeb is a web application library |

currentversion = [http://gnustep.org] |

releasedate = use SVN |

license = LGPL2|

overview = GNUstepWeb is a development framework for web applications written in Objective-C which is designed to be source-code compatible with [http://www.apple.com/webobjects/ WebObjects] 4.5 - a product originally developed by NeXT Inc, whose newer versions have been released by Apple and are Java-based. |

features = This library is a component of the [[GNUstep]] project in the dev-libs section and is available in the standard ways - such as the [ftp://ftp.gnustep.org/pub/daily-snapshots/dev-libs.current.tar.bz2 GNUstep ftp site].

David Wetzel recommends using the current version that can be obtained by executing the following [[SVN]] check out in an empty directory
svn co http://svn.gna.org/svn/gnustep/libs/gsweb/trunk

|

maintainer = David Wetzel |

Installation tips =
* Install GNUstep core and gdl2 components
* Install Apache 2.x
* Download svn current version (see above)
* Install Apache2 / GNUstepWeb adaptor module (see GSWAdaptors/Apache/INSTAL in GNUstepWeb Tree)
* Setup Adaptor configuration (see GSWAdaptors/Apache/INSTAL)
* Build and install GNUstepWeb (see INSTALL) in GNUstepWeb Tree
* Build and install Examples/hello (see Examples/hello/INSTALL)
* Run hello
* Point your browser to: http://localhost/GSWeb/hello.gswa.

|

relatedlinks =
* Apple has [http://developer.apple.com/documentation/LegacyTechnologies/WebObjects/WebObjects_4.5/webobjects.html legacy WebObjects 4.5 documentation] available.
* David Wetzel runs a low-volume mailing list called [http://lists.turbocat.net/mailman/listinfo.cgi/gswhackers gswhackers].
* [[Creating A Simple GSWeb Application]] is very easy. |

category = [[Category:GNUstepWeb]] [[Category:Networking_Frameworks]]
}}

Apache2Adaptor

2007-12-01T20:10:28Z

Dwetzel: /* Configuration */

== Introduction ==

After you have created a [[GNUstepWeb]] application, you might want to deploy it. The Apache 2 adaptor is a module that loads into your apache server.
If somebody asks your web server for a dynamic web page it will forward the request to the appropriate application instance.

== Configuration ==

The main difference between the older adaptors and the new one for Apache2 is that all configuration is done per virtual host context. In addition, no special config file is nessesary. All can go into httpd.conf.

'''ShowApps on''' will dump a list of configured applications.

'''ShowApps off''' hides that list.

'''App Name='''''appname'' '''Instance='''''instancenumber'' '''Host='''''IP or Hostname'':''port''

==== Example ====

ShowApps on
App Name=TCWebMail Instance=1 Host=10.1.0.1:9901
App Name=PBX Instance=1 Host=127.0.0.1:9001

Your application should be reachable at http://www.example.com/wo/appname.woa/

==== Accessing WO 5 Applications via our Adaptor ====

App Name=HelloWorld Instance=1 Host= 10.1.0.99:4711
RewriteEngine On
RewriteRule ^/cgi-bin/WebObjects/HelloWorld.woa/(.*)$ /wo/HelloWorld.woa/$1 [L,PT,QSA]

Start your HelloWorld like this

./dist/selfcontained/HelloWorld.woa/HelloWorld -WOPort 4711

This will show you the Java HelloWorld if you point your browser to http://www.example.com/cgi-bin/WebObjects/HelloWorld.woa/

== Notes ==

If the adaptor receives an request it cannot forward to the requested application, it will list the configured applications if '''ShowApps on''' was configured. Otherwise just a useless page is displayed.

This adaptor was written from scratch, based on Apache2 example code. It does not require any additional libraries or frameworks other than GSWeb and Apache2. It does not need libProplist.

----

[[Category:GNUstepWeb]]
[[Category:Development]]

Apache2Adaptor

2007-11-24T21:32:24Z

Dwetzel: /* Configuration */

== Introduction ==

After you have created a [[GNUstepWeb]] application, you might want to deploy it. The Apache 2 adaptor is a module that loads into your apache server.
If somebody asks your web server for a dynamic web page it will forward the request to the appropriate application instance.

== Configuration ==

The main difference between the older adaptors and the new one for Apache2 is that all configuration is done per virtual host context. In addition, no special config file is nessesary. All can go into httpd.conf.

'''ShowApps on''' will dump a list of configured applications.

'''ShowApps off''' hides that list.

'''App Name='''''appname'' '''Instance='''''instancenumber'' '''Host='''''IP or Hostname'':''port''

==== Example ====

ShowApps on
App Name=TCWebMail Instance=1 Host=10.1.0.1:9901
App Name=PBX Instance=1 Host=127.0.0.1:9001

Your application should be reachable at http://www.example.com/wo/appname.woa/

== Notes ==

If the adaptor receives an request it cannot forward to the requested application, it will list the configured applications if '''ShowApps on''' was configured. Otherwise just a useless page is displayed.

This adaptor was written from scratch, based on Apache2 example code. It does not require any additional libraries or frameworks other than GSWeb and Apache2. It does not need libProplist.

----

[[Category:GNUstepWeb]]
[[Category:Development]]

GNUstepWeb

2007-04-13T18:35:15Z

Dwetzel:

{{Framework|
shortdescription = GNUstepWeb is a web application library |

currentversion = [http://gnustep.org] |

releasedate = use SVN |

license = LGPL2|

overview = GNUstepWeb is a development framework for web applications written in Objective-C which is designed to be source-code compatible with [http://www.apple.com/webobjects/ WebObjects] 4.5 - a product originally developed by NeXT Inc, whose newer versions have been released by Apple and are Java-based. |

features = This library is a component of the [[GNUstep]] project in the dev-libs section and is available in the standard ways - such as the [ftp://ftp.gnustep.org/pub/daily-snapshots/dev-libs.current.tar.bz2 GNUstep ftp site].

David Wetzel recommends using the current version that can be obtained by executing the following [[SVN]] check out in an empty directory
svn co http://svn.gna.org/svn/gnustep/libs/gsweb/trunk

|

maintainer = David Wetzel |

relatedlinks =
* Apple has [http://developer.apple.com/documentation/LegacyTechnologies/WebObjects/WebObjects_4.5/webobjects.html legacy WebObjects 4.5 documentation] available. Please note that the official site [http://www.gnustepweb.org/ gnustepweb.org] is somewhat out of date.
* David Wetzel runs a low-volume mailing list called [http://lists.turbocat.net/mailman/listinfo.cgi/gswhackers gswhackers].
* [[Creating A Simple GSWeb Application]] is very easy. |

category = [[Category:GNUstepWeb]] [[Category:Networking_Frameworks]]
}}

User:Dwetzel

2007-04-11T20:21:08Z

Dwetzel:

'''David Wetzel'''

'''E-mail''': dave at turbocat dot de

'''Voice''': +49 33056 82834 (Central Europe)

Apache2Adaptor

2007-04-11T15:32:27Z

Dwetzel:

== Introduction ==

After you have created a [[GNUstepWeb]] application, you might want to deploy it. The Apache 2 adaptor is a module that loads into your apache server.
If somebody asks your web server for a dynamic web page it will forward the request to the appropriate application instance.

== Configuration ==

The main difference between the older adaptors and the new one for Apache2 is that all configuration is done per virtual host context. In addition, no special config file is nessesary. All can go into httpd.conf.

'''ShowApps on''' will dump a list of configured applications.

'''ShowApps off''' hides that list.

'''App Name='''''appname'' '''Instance='''''instancenumber'' '''Host='''''IP or Hostname'':''port''

==== Example ====

ShowApps on
App Name=TCWebMail Instance=1 Host=10.1.0.1:9901
App Name=PBX Instance=1 Host=127.0.0.1:9001

== Notes ==

If the adaptor receives an request it cannot forward to the requested application, it will list the configured applications if '''ShowApps on''' was configured. Otherwise just a useless page is displayed.

This adaptor was written from scratch, based on Apache2 example code. It does not require any additional libraries or frameworks other than GSWeb and Apache2. It does not need libProplist.

----

[[Category:GNUstepWeb]]
[[Category:Development]]

Apache2Adaptor

2007-04-11T15:29:11Z

Dwetzel:

GSWeb application deployment

2007-04-11T15:04:17Z

Dwetzel:

Please extend this doc -- dw

You can read about the new [[Apache2Adaptor]] to serve your dynamic pages using Apache 2.

----

[[Category:GNUstepWeb]]

Category:GNUstepWeb

2007-04-11T14:59:34Z

Dwetzel:

[[Category:GNUstepWeb]]

GNUstepWeb

2007-04-10T22:57:31Z

Dwetzel:

{{Framework|
shortdescription = GNUstepWeb is a web application library |

currentversion = [http://gnustep.org] |

releasedate = use SVN |

license = LGPL2|

overview = GNUstepWeb is a development framework for web applications written in Objective-C which is designed to be source-code compatible with [http://www.apple.com/webobjects/ WebObjects] 4.5 - a product originally developed by NeXT Inc, whose newer versions have been released by Apple and are Java-based. |

features = This library is a component of the [[GNUstep]] project in the dev-libs section and is available in the standard ways - such as the [ftp://ftp.gnustep.org/pub/daily-snapshots/dev-libs.current.tar.bz2 GNUstep ftp site].

David Wetzel recommends using his recent branch that can be obtained by executing the following [[SVN]] check out in an empty directory
svn co http://svn.gna.org/svn/gnustep/libs/gsweb/branches/06-02-dwetzel

There is currently (April 2007) a merge in progress. The new experimental Apache2 adaptor is already in trunk.
|

maintainer = David Wetzel |

relatedlinks =
* Apple has [http://developer.apple.com/documentation/LegacyTechnologies/WebObjects/WebObjects_4.5/webobjects.html legacy WebObjects 4.5 documentation] available. Please note that the official site [http://www.gnustepweb.org/ gnustepweb.org] is somewhat out of date.
* David Wetzel runs a low-volume mailing list called [http://lists.turbocat.net/mailman/listinfo.cgi/gswhackers gswhackers].
* [[Creating A Simple GSWeb Application]] is very easy. |

category = [[Category:GNUstepWeb]] [[Category:Networking_Frameworks]]
}}

GSWComponent

2007-01-02T10:34:28Z

Dwetzel:

== Introduction ==

Componets are the basic building blocks for [[GNUstepWeb]].

Every componet is a directory. A component can represent a whole web page or just a part of it. It is easy to re-use pieces needed multiple times.
A component contains three files they contain the HTML, the connections or bindings of your objects and additional information like the used encoding. Those files are suffixed .html, .wod and .woo.

If we use the WO Name syntax (Tags Named WEBOBJECT) we have the advantage of Web Objects Builder compatibility.

[[Image:Wobuilder.jpg]]

== Contents of a WO File Wrapper ==

user@host>ls LoginComponent.wo/
LoginComponent.html LoginComponent.wod LoginComponent.woo

== html file ==
<code>

<webobject name=LoggedInCon><webobject name=LoginForm>
<div class="logbar">
<p class="center">Login to see your calls and account.</p>
<p class="right">Email:
<webobject name=EmailField></webobject></p>
<p class="right">Password:
<webobject name=PasswordField></webobject></p>
<p class="center">
<webobject name="LoginButton"></webobject><webobject name=ErrorCond>Error</webobject></p>
</div>
</webobject></webobject><webobject name=LoggedInCon2>
<div class="logbar">
<h2>My Account</h2>
<p class="center"><webobject name=emailString></webobject></p>
<p class="center"><webobject name=logoutLink>Log out</webobject></p>
</div>
</webobject>

</code>

== wod file ==

EmailField: WOTextField {
value = email;
size = 16;
name = "email";
}

ErrorCond: WOConditional {
condition = loginError;
}

LoggedInCon: WOConditional {
condition = session.client;
negate = true;
}

LoggedInCon2: WOConditional {
condition = session.client;
}

LoginButton: WOSubmitButton {
value = "Login";
directActionName = "login";
}

LoginForm: WOForm {
actionClass = "";
}

PasswordField: WOPasswordField {
value = password;
size = 16;
name = "password";
}

emailString: WOString {
value = session.client.eMail;
valueWhenEmpty = "me@example.com";
}

logoutLink: WOHyperlink {
action = logout;
}

== woo file ==

Note that this file is also important. GSWeb uses the encoding information here to load the component. Older versions (DW: trunk still in Jan 2007) do not use this file. If this file is not present, GSWeb will not find the component.

{
"WebObjects Release" = "WebObjects 5.0";
encoding = NSUTF8StringEncoding;
}

== The component in a web browser ==

After the page is being transferred to the web browser, it looks like that. (Note that the background image comes from a different component.)

[[Image:Component_in_browser.jpg]]

----

[[Category:GNUstepWeb]]
[[Category:Development]]

GSWComponent

2007-01-02T10:32:55Z

Dwetzel:

== Introduction ==

Componets are the basic building blocks for [[GNUstepWeb]].

Every componet is a directory. A component can represent a whole web page or just a part of it. It is easy to re-use pieces needed multiple times.
A component contains three files they contain the HTML, the connections or bindings of your objects and additional information like the used encoding. Those files are suffixed .html, .wod and .woo.

If we use the WO Name syntax (Tags Named WEBOBJECT) we have the advantage of Web Objects Builder compatibility.

[[Image:Wobuilder.jpg]]

== Contents of a WO File Wrapper ==

user@host>ls LoginComponent.wo/
LoginComponent.html LoginComponent.wod LoginComponent.woo

== html file ==
<code>

<webobject name=LoggedInCon><webobject name=LoginForm>
<div class="logbar">
<p class="center">Login to see your calls and account.</p>
<p class="right">Email:
<webobject name=EmailField></webobject></p>
<p class="right">Password:
<webobject name=PasswordField></webobject></p>
<p class="center">
<webobject name="LoginButton"></webobject><webobject name=ErrorCond>Error</webobject></p>
</div>
</webobject></webobject><webobject name=LoggedInCon2>
<div class="logbar">
<h2>My Account</h2>
<p class="center"><webobject name=emailString></webobject></p>
<p class="center"><webobject name=logoutLink>Log out</webobject></p>
</div>
</webobject>

</code>

== wod file ==

EmailField: WOTextField {
value = email;
size = 16;
name = "email";
}

ErrorCond: WOConditional {
condition = loginError;
}

LoggedInCon: WOConditional {
condition = session.client;
negate = true;
}

LoggedInCon2: WOConditional {
condition = session.client;
}

LoginButton: WOSubmitButton {
value = "Login";
directActionName = "login";
}

LoginForm: WOForm {
actionClass = "";
}

PasswordField: WOPasswordField {
value = password;
size = 16;
name = "password";
}

emailString: WOString {
value = session.client.eMail;
valueWhenEmpty = "me@example.com";
}

logoutLink: WOHyperlink {
action = logout;
}

== woo file ==

Note that this file is also important. GSWeb uses the encoding information here to load the component. Older versions (DW: trunk still in Jan 2007) do not use this file. If this file is not present, GSWeb will not find the component.

{
"WebObjects Release" = "WebObjects 5.0";
encoding = NSUTF8StringEncoding;
}

== The component in a web browser ==

After the page is being transferred to the web browser, it looks like that.

[[Component_in_browser.jpg]]

----

[[Category:GNUstepWeb]]
[[Category:Development]]

File:Component in browser.jpg

2007-01-02T10:30:49Z

Dwetzel: The example component in browser without a user logged in.

The example component in browser without a user logged in.

GSWComponent

2007-01-02T10:27:07Z

Dwetzel:

== Introduction ==

Componets are the basic building blocks for [[GNUstepWeb]].

Every componet is a directory. A component can represent a whole web page or just a part of it. It is easy to re-use pieces needed multiple times.
A component contains three files they contain the HTML, the connections or bindings of your objects and additional information like the used encoding. Those files are suffixed .html, .wod and .woo.

If we use the WO Name syntax (Tags Named WEBOBJECT) we have the advantage of Web Objects Builder compatibility.

[[Image:Wobuilder.jpg]]

== Contents of a WO File Wrapper ==

user@host>ls LoginComponent.wo/
LoginComponent.html LoginComponent.wod LoginComponent.woo

== html file ==
<code>

<webobject name=LoggedInCon><webobject name=LoginForm>
<div class="logbar">
<p class="center">Login to see your calls and account.</p>
<p class="right">Email:
<webobject name=EmailField></webobject></p>
<p class="right">Password:
<webobject name=PasswordField></webobject></p>
<p class="center">
<webobject name="LoginButton"></webobject><webobject name=ErrorCond>Error</webobject></p>
</div>
</webobject></webobject><webobject name=LoggedInCon2>
<div class="logbar">
<h2>My Account</h2>
<p class="center"><webobject name=emailString></webobject></p>
<p class="center"><webobject name=logoutLink>Log out</webobject></p>
</div>
</webobject>

</code>

== wod file ==

EmailField: WOTextField {
value = email;
size = 16;
name = "email";
}

ErrorCond: WOConditional {
condition = loginError;
}

LoggedInCon: WOConditional {
condition = session.client;
negate = true;
}

LoggedInCon2: WOConditional {
condition = session.client;
}

LoginButton: WOSubmitButton {
value = "Login";
directActionName = "login";
}

LoginForm: WOForm {
actionClass = "";
}

PasswordField: WOPasswordField {
value = password;
size = 16;
name = "password";
}

emailString: WOString {
value = session.client.eMail;
valueWhenEmpty = "me@example.com";
}

logoutLink: WOHyperlink {
action = logout;
}

== woo file ==

Note that this file is also important. GSWeb uses the encoding information here to load the component. Older versions (DW: trunk still in Jan 2007) do not use this file. If this file is not present, GSWeb will not find the component.

{
"WebObjects Release" = "WebObjects 5.0";
encoding = NSUTF8StringEncoding;
}

----

[[Category:GNUstepWeb]]
[[Category:Development]]

GSWComponent

2007-01-02T10:20:28Z

Dwetzel:

GSWComponent

2007-01-02T10:14:21Z

Dwetzel: /* Contents of a WO File Wrapper */

GSWComponent

2007-01-02T10:03:53Z

Dwetzel:

File:Wobuilder.jpg

2007-01-02T09:59:24Z

Dwetzel: WO Builder showing a component

WO Builder showing a component

Creating A Simple GSWeb Application

2007-01-02T09:56:17Z

Dwetzel:

== Introduction ==

[[GNUstepWeb]] is a framework for creating web-based applications using Objective-C. This guide aims to provide an overview of what is required in the creation and design of a very simple web application.

It is assumed you are familiar with GNUstep, and have a working GNUstep installation, including the [[GDL2]] and [[GSWeb]] frameworks. Pre-requisites for [[GSWeb application deployment]] should also be in place.

== File Components ==

In building your web application you will need to create a number of files. From scratch, the following should be a rough guide to getting it working. These include the Makefile, ...

=== The Makefile ===

For a web application, a special makefile is needed: luckily it's very similar to makefiles you may have used for other kinds of project. There is currently no out-of-the-box way to have these files built for you, so you'll have to do it manually.

'''GNUmakefile'''

For more information as to customising this file, as well as setting up compiler options for third party libraries and includes, see the GNUstep makefile manual.

=== Components ===

GSWeb uses a directory for every component. A component can represent a whole web page or just a part of it. It is easy to re-use pieces needed multiple times.
A component contains three files they contain the HTML, the connections or bindings of your objects and additional information like the used encoding. Those files are suffixed .html, .wod and .woo.
A more in-depth description of [[GSWComponent|Components]] is available.

===The application dictionary===

=== Interface files ===

----

[[Category:GNUstepWeb]]
[[Category:Development]]

GSWComponent

2007-01-02T09:55:22Z

Dwetzel:

Creating A Simple GSWeb Application

2007-01-02T09:51:41Z

Dwetzel:

== Introduction ==

[[GNUstepWeb]] is a framework for creating web-based applications using Objective-C. This guide aims to provide an overview of what is required in the creation and design of a very simple web application.

It is assumed you are familiar with GNUstep, and have a working GNUstep installation, including the [[GDL2]] and [[GSWeb]] frameworks. Pre-requisites for [[GSWeb application deployment]] should also be in place.

== File Components ==

In building your web application you will need to create a number of files. From scratch, the following should be a rough guide to getting it working. These include the Makefile, ...

=== The Makefile ===

For a web application, a special makefile is needed: luckily it's very similar to makefiles you may have used for other kinds of project. There is currently no out-of-the-box way to have these files built for you, so you'll have to do it manually.

'''GNUmakefile'''

For more information as to customising this file, as well as setting up compiler options for third party libraries and includes, see the GNUstep makefile manual.

=== Components ===

GSWeb uses a directory for every component. A component can represent a whole web page or just a part of it. It is easy to re-use pieces needed multiple times.
A component contains thee files they contain the HTML, the connections or bindings of your objects and additional information like the used encoding. Those files are suffixed .html, .wod and .woo.
A more in-depth description of [[GSWComponent|Components]] is available.

===The application dictionary===

=== Interface files ===

----

[[Category:GNUstepWeb]]
[[Category:Development]]

GNUstep in production

2006-12-29T11:59:22Z

Dwetzel:

''Note: Please leave a short note about how is the company related to GNUstep. Please sort the list alphabetically.''

== Corporations & Companies actively developing for GNUstep ==

* [http://www.brainstorm.co.uk/ Brainstorm Computer Solutions]
* [http://www.orange-concept.com/ Orange Concept] is working mainly on [http://www.gnustepweb.org GNUstepWeb] and [[GDL|GDL2]] for it's eCommerce engine: [http://www.eCommStep.com eCommStep]
* [http://www.turbocat.de/ Turbocat's Development]

== Companies which use and/or support GNUstep ==

* [http://www.turbocat.de/ Turbocat's Development]
* [http://www.intars.at/ Ayers Application Design & Development]
* [http://www.ivt.baug.ethz.ch/oev/RailMLEditor_d.html Institut für Verkehrsplanung und Transportsysteme]
* [http://www.cyberdvdfilms.com Microcom]<br>uses [http://www.eCommStep.com eCommStep], an eCommerce engine based on [http://www.gnustep.org GNUstep], [http://www.gnustepweb.org GNUstepWeb] and [[GDL2]] to run its shop since may 2003.
* Orillion
* [http://www.seat-1.com seat-1 Software GmbH ], business software for small to medium-sized production, trading and service companies. The software product IntarS is powered by [[GNUstepWeb]] on GNU based operating systems.

* [[Smartsoft]] develops highly customized business applications for MacOSX and Solaris.
* [http://www.theinternetco.net/ The Internet Company]

Creating A Simple GSWeb Application

2006-12-29T10:11:31Z

Dwetzel:

== Introduction ==

[[GNUstepWeb]] is a framework for creating web-based applications using Objective-C. This guide aims to provide an overview of what is required in the creation and design of a very simple web application.

It is assumed you are familiar with GNUstep, and have a working GNUstep installation, including the [[GDL2]] and [[GSWeb]] frameworks. Pre-requisites for [[GSWeb application deployment]] should also be in place.

== File Components ==

In building your web application you will need to create a number of files. From scratch, the following should be a rough guide to getting it working. These include the Makefile, ...

=== The Makefile ===

For a web application, a special makefile is needed: luckily it's very similar to makefiles you may have used for other kinds of project. There is currently no out-of-the-box way to have these files built for you, so you'll have to do it manually.

'''GNUmakefile'''

For more information as to customising this file, as well as setting up compiler options for third party libraries and includes, see the GNUstep makefile manual.

=== Components ===

GSWeb uses a directory for every component. A component can represent a whole web page or just a part of it. It is easy to re-use pieces needed multiple times.
A component contains thee files they contain the HTML, the connections or bindings of your objects and additional information like the used encoding. Those files are suffixed .html, .wod and .woo.

(DW:More about GSWeb Components should be in a separate article)

===The application dictionary===

=== Interface files ===

----

[[Category:GNUstepWeb]]
[[Category:Development]]

Developer Guides

2006-12-28T19:56:23Z

Dwetzel:

This page is intended as a collection of guides for developers.

== Introductory Articles on GNUstep Development ==

{{Stub}}

=== [[GNUstep Suite|Introduction to GNUstep Libraries and Tools]] ===

A general overview of GNUstep.

=== [http://www.gnustep.org/resources/documentation/Developer/Base/ProgrammingManual/manual_toc.html Introduction to GNUstep (Foundation) Programming] ===

The aim of this manual is to introduce you to the Objective-C language and the GNUstep development environment, in particular the Base library. The manual is organised to give you a tutorial introduction to the language and APIs, by using examples whenever possible, rather than providing a lengthy abstract description.

While Objective-C is not a difficult language to learn or use, some of the terms may be unfamiliar, especially to those that have not programmed using an object-oriented programming language before. Whenever possible, concepts will be explained in simple terms rather than in more advanced programming terms, and comparisons to other languages will be used to aid in illustration.

=== [http://www.roard.com/docs/lmf2.article/en.html (GUI) Programming under GNUstep] ===

This guide will introduce you to the [[AppKit]] classes and how to use [[Gorm]] to create graphical interfaces.

=== [[Writing Makefiles]] ===

The Makefile package is a system of make commands that is designed to encapsulate all the complex details of building and installing various types of projects from libraries to applications to documentation. This frees the developer to focus on the details of their particular project. Only a fairly simple main makefile need to be written which specifies the type of project and files involved in the project.

=== [ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-examples-1.1.0.tar.gz Sample GNUstep Programs] ===

This isn't really an article but rather a collection of small "codified guides" for the pragmatic programmer who wants to explore GNUstep by looking at and messing around with example code. This is best done while reading about basic concepts of OpenStep or Cocoa with the API documentation ([[Foundation]], [[AppKit]]) open in the background.

== General ==

=== [[Writing portable code|Coding for Portability]] ===

Writing code that will compile and then run on different platforms can be surprisingly easy. This guide describes
some straight-forward steps to take to make your program easy to port to new platforms.

=== [[Property Lists|Using Property Lists]] ===

A regular issue that programmers face is storing structured configuration information, and reading it back. GNUstep has a standard mechanism that can be used for this task, amongst others: Property Lists.

=== [[Deployment on Windows]] ===

This article will tell you how to deploy GNUstep applications on Windows.

== Graphical Applications ==

=== Simple Graphical Application Design ===
GNUstep includes several sophisticated development tools. GNUstep GUI interfaces are designed using [[Gorm]] (Graphical Object Relationship Modeler), an elegant application developed by Gregory Casamento. (See his [http://heronsperch.blogspot.com/ blog] for the latest news on GORM.) There are two proto-IDEs, [[ProjectCenter]] and [[ProjectManager]].

There are several introductory tutorials for using these development tools. The first [http://www.gnustep.it/pierre-yves/index.html tutorial] by Pierre-Yves Rivaille is a classic demonstrating the process used to create the ubiquitous currency converter application. A second [http://www.nongnu.org/gstutorial/ tutorial] by Yen-Ju Chen is somewhat more in-depth and extensive.

Nicolas Roard created a [http://gnustep.org/experience/DevelopmentDemonstration.html video] demonstrating the process of developing a simple calculator, and another [http://home.gna.org/pmanager/videos.html video] here by Sašo Kiselkov if you feel the need to create another currency converter.

=== [[Document based applications|Document-based Application Design]] ===

One of the most common use-patterns of applications on modern platforms is that of document-based applications --- applications which can have several active user-controlled contexts. Some familar examples might be a word processor where the user may have multiple document windows concurrently, or a web browser which allows a user to have a number of different browser windows open at the same time. This guide provides information and tips on how to code this style of application.

== Web Applications ==

Please have a look at [[Creating A Simple GSWeb Application]] to learn how to create a [[GNUstepWeb|GNUstep Web]] application.

== Other Information ==

=== Developer sites ===

* [http://www.roard.com/docs/ GNUstep HelpCenter]

[[Category:Development]]

GNUstepWeb

2006-12-28T19:47:37Z

Dwetzel:

{{Framework|
shortdescription = GNUstepWeb is a web application library |
currentversion = [http://gnustep.org] |
releasedate = use SVN |
license = LGPL2|
overview = GNUstepWeb is a development framework for web applications written in Objective-C which is designed to be source-code compatible with [[WebObjects]] 4.5 - a product originally developed by NeXT Inc, whose newer versions have been released by Apple and are Java-based. |
features = |
maintainer = David Wetzel |
relatedlinks = |
category = [[Category:Networking_Frameworks]]
}}

=== Availability ===
This library is a component of the [[GNUstep]] project in the dev-libs section and is available in the standard ways - such as the [ftp://ftp.gnustep.org/pub/daily-snapshots/dev-libs.current.tar.bz2 GNUstep ftp site].

David Wetzel recommends using his recent branch that can be obtained by executing the following [[SVN]] check out in an empty directory
svn co http://svn.gna.org/svn/gnustep/libs/gsweb/branches/06-02-dwetzel

=== Documentation and Resources ===
Apple has [http://developer.apple.com/documentation/LegacyTechnologies/WebObjects/WebObjects_4.5/webobjects.html legacy WebObjects 4.5 documentation] available. Please note that the official site is [http://www.gnustepweb.org/ gnustepweb.org] is somewhat out of date.

David Wetzel runs a low-volume mailing list called [http://lists.turbocat.net/mailman/listinfo.cgi/gswhackers gswhackers].

=== Tutorials ===
[[Creating A Simple GSWeb Application]] is very easy.

[[Category:GNUstepWeb]]
[[Category:Networking_Frameworks]]

Summer Of Code 2006

2006-04-20T10:24:36Z

Dwetzel: /* Mentors */

== Summer Of Code 2006 ==

The [http://code.google.com/soc/ Summer Of Code] is a Google program that offers student developers stipends to create new open source programs or to help currently established projects. It would be an excellent opportunity for GNUstep to fund some developments.

Here is some ideas:

- Improve the Printing Support (better postcript generation, etc.)

- Bindings, KVO support

- Improve the Cairo backend

- Improve Windows support

- Improve GNUstepWeb (add script language support, etc)

- Create a AJAX Framework for GNUstepWeb

- Finish input server [http://svn.gna.org/viewcvs/gnustep/libs/gui/branches/kazunobu_input_management/ support]

- Port WebCore to GNUstep using gcc4.1

- Compare current API with Tiger API, indicates which are missing, and the status of the existing ones, then work to complete them... ;)

Feel free to add other ideas !

== Note ==

We need [http://code.google.com/soc/mentorfaq.html mentor(s)] to manage the volunteers...

=== Mentors ===

- David Wetzel (dave at turbocat dot de) could mentor GSWeb related projects

=== Students ===

Nicolas Roard

Summer Of Code 2006

2006-04-20T10:24:19Z

Dwetzel: /* Mentors */

== Summer Of Code 2006 ==

The [http://code.google.com/soc/ Summer Of Code] is a Google program that offers student developers stipends to create new open source programs or to help currently established projects. It would be an excellent opportunity for GNUstep to fund some developments.

Here is some ideas:

- Improve the Printing Support (better postcript generation, etc.)

- Bindings, KVO support

- Improve the Cairo backend

- Improve Windows support

- Improve GNUstepWeb (add script language support, etc)

- Create a AJAX Framework for GNUstepWeb

- Finish input server [http://svn.gna.org/viewcvs/gnustep/libs/gui/branches/kazunobu_input_management/ support]

- Port WebCore to GNUstep using gcc4.1

- Compare current API with Tiger API, indicates which are missing, and the status of the existing ones, then work to complete them... ;)

Feel free to add other ideas !

== Note ==

We need [http://code.google.com/soc/mentorfaq.html mentor(s)] to manage the volunteers...

=== Mentors ===

-- David Wetzel (dave at turbocat dot de) could mentor GSWeb related projects

=== Students ===

Nicolas Roard

Summer Of Code 2006

2006-04-20T10:19:20Z

Dwetzel: /* Summer Of Code 2006 */