JSAN::Index - JavaScript Archive Network (JSAN) SQLite/ORLite Index
JSAN is the JavaScript Archive Network, a port of CPAN to JavaScript.
You can find the JSAN at http://openjsan.org.
As well as a flat text file index like CPAN, the JSAN index is also distributed as a DBD::SQLite database.
JSAN::Index is a ORLite wrapper built around the JSAN SQLite index.
JSAN::Index
It allow you to easily do all sorts of nifty things with the index in a simple and straight forward way.
Once loaded, most of the functionality of the index is accessed through the classes that implement the various objects in the index.
These are:
An author is a single human (or under certain very special circumstances a company or mailing list) that creates distributions and uploads them to the JSAN.
A distribution is a single software component that may go through a number of releases
A release is a compressed archive file containing a single version of a paricular distribution.
A library is a single class, or rather a "pseudo-namespace", that defines an interface to provide some functionality. Distributions often contain a number of libraries, making up a complete "API".
There are only a very limited number of utility methods available directly from the JSAN::Index class itself.
The init method initializes the JSAN index adapter. It takes a set of parameters and initializes the JSAN::Index class. JSAN::Index is a singleton, so only it can initialized only once. Any further attempts to do so will result in an exception being thrown.
init
The dependency method creates and returns an dependency resolution object that is used by JSAN::Client to schedule which releases to install.
dependency
If the optional parameter 'build' is true, creates a build-time dependency resolve, which will additionally install releases only needed for testing.
Returns an Algorithm::Dependency object.
This accessor return an instance of JSAN::Transport, which can be used for managing files of current mirror.
This accessor return a singleton instance of JSAN::Index, or undef is its not initialized yet.
my $string = JSAN::Index->dsn;
The dsn accessor returns the DBI connection string used to connect to the SQLite database as a string.
dsn
my $handle = JSAN::Index->dbh;
To reliably prevent potential SQLite deadlocks resulting from multiple connections in a single process, each ORLite package will only ever maintain a single connection to the database.
During a transaction, this will be the same (cached) database handle.
Although in most situations you should not need a direct DBI connection handle, the dbh method provides a method for getting a direct connection in a way that is compatible with connection management in ORLite.
dbh
Please note that these connections should be short-lived, you should never hold onto a connection beyond your immediate scope.
The transaction system in ORLite is specifically designed so that code using the database should never have to know whether or not it is in a transation.
Because of this, you should never call the ->disconnect method on the database handles yourself, as the handle may be that of a currently running transaction.
Further, you should do your own transaction management on a handle provided by the <dbh> method.
In cases where there are extreme needs, and you absolutely have to violate these connection handling rules, you should create your own completely manual DBI->connect call to the database, using the connect string provided by the dsn method.
The dbh method returns a DBI::db object, or throws an exception on error.
The selectall_arrayref method is a direct wrapper around the equivalent DBI method, but applied to the appropriate locally-provided connection or transaction.
selectall_arrayref
It takes the same parameters and has the same return values and error behaviour.
The selectall_hashref method is a direct wrapper around the equivalent DBI method, but applied to the appropriate locally-provided connection or transaction.
selectall_hashref
The selectcol_arrayref method is a direct wrapper around the equivalent DBI method, but applied to the appropriate locally-provided connection or transaction.
selectcol_arrayref
The selectrow_array method is a direct wrapper around the equivalent DBI method, but applied to the appropriate locally-provided connection or transaction.
selectrow_array
The selectrow_arrayref method is a direct wrapper around the equivalent DBI method, but applied to the appropriate locally-provided connection or transaction.
selectrow_arrayref
The selectrow_hashref method is a direct wrapper around the equivalent DBI method, but applied to the appropriate locally-provided connection or transaction.
selectrow_hashref
The prepare method is a direct wrapper around the equivalent DBI method, but applied to the appropriate locally-provided connection or transaction
prepare
In general though, you should try to avoid the use of your own prepared statements if possible, although this is only a recommendation and by no means prohibited.
# Get the user_version for the schema my $version = JSAN::Index->pragma('user_version');
The pragma method provides a convenient method for fetching a pragma for a datase. See the SQLite documentation for more details.
pragma
JSAN::Index is based on ORLite 1.25.
Documentation created by ORLite::Pod 0.07.
For general support please see the support section of the main project documentation.
Copyright 2009 - 2010 Adam Kennedy.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included with this module.
To install JSAN::Client, copy and paste the appropriate command in to your terminal.
cpanm
cpanm JSAN::Client
CPAN shell
perl -MCPAN -e shell install JSAN::Client
For more information on module installation, please visit the detailed CPAN module installation guide.