Reference | Help | Introduction | Slide Show | Class Hierarchy InterClient
PREV | NEXT FRAMES  | NO FRAMES

Database and Server URL Syntax

A database URL is used by a JDBC driver to establish a connection to a database. The general form of an InterBase database URL is 

jdbc:interbase://hostName:interserverPortNumber/databaseFileSpecification
By default, the InterServer service listens on port 3060. So normally, the portNumber is not given and the form of the database URL is 
jdbc:interbase://hostName/databaseFileSpecification
On Unix file systems, the databaseFileSpecification starts from a root "/", so a typical database URL on a Unix host may be 
jdbc:interbase://pongo//databases/employee.gdb
On Windows file systems, the databaseFileSpecification may start with a driver letter, such as "d:", or it may start from a root "/" using the default drive. So a typical database URL on a Windows host may be 
jdbc:interbase://pongo/c:/databases/employee.gdb

InterServer has the ability to reside on a middle tier and proxy service to a remote InterBase server. In this case, the databaseFileSpecification must be recognizable as a remote database by the InterBase client library. So, if InterServer resides on host "pongo", and the InterBase server resides on host "perdy", then a typical database URL may be 

jdbc:interbase://pongo/perdy:/databases/employee.gdb

InterClient will also support server URLs as an extension to JDBC. Server URLs will be used for attaching to an InterServer service for administering an InterBase server. A service attachment is represented by a Server object in the InterClient API.

The syntax for a server URL is the same as a database URL except for the trailing databaseFileSpecification. A database URL may also be used as a server URL, in which case the trailing databaseFileSpecification is ignored. So a typical server URL for administering an InterBase server on pongo may be 

jdbc:interbase://pongo
InterServer may also be used to administer an InterBase server on another machine. In this case the InterBase host name is specified after the InterServer host name as follows 
jdbc:interbase://pongo/perdy

For example usage, see the InterClient examples directory for class FirstExample.java

Reference | Help | Introduction | Slide Show | Class Hierarchy InterClient
PREV | NEXT FRAMES  | NO FRAMES
Send comments or suggestions to icsupport@interbase.com