|
|||||||||
| Home >> All >> org >> crosswire >> bible >> [ book overview ] | PREV CLASS NEXT CLASS | ||||||||
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD |
DETAIL: FIELD | CONSTR | METHOD | ||||||||
org.crosswire.bible.book
Interface BookMetaData
- All Known Subinterfaces:
- BibleMetaData
- public interface BookMetaData
A Version represents a method of translating the Bible. All Bibles with
the same Version should return identical text for any call to
Bible.getText(VerseRange). The implication of this is that
there may be many instances of the Version "NIV", as there are several
different versions of the NIV - Original American-English, Anglicized,
and Inclusive Language editions at least.
Versions like Strings must be compared using .equals()
instead of ==. A Bible must have the ability to handle a version
unknown to ProjectB. So Bibles must be able to add versions to the
system, and the system must cope with versions that already exist.
I recommend that all Versions are created by the Bibles class and
not using new Version() or new BasicVersion()
because implementations of Bible should not all need to know all the
ins and outs of the versions that they provide because that would mean
lots of duplication of data - a centralized store of fine details would
be better.
|
Distribution Licence: Project B is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2 as published by the Free Software Foundation. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. The License is available on the internet here, by writing to Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA, Or locally at the Licence link below. The copyright to this program is held by it's authors. |
- Version:
- $Id:$
| Field Summary | |
static int |
STATUS_COMMERCIAL
Is the data sold for commercial profit |
static int |
STATUS_COPYABLE
Is the data freely redistributable |
static int |
STATUS_FREE
Does the data have a licence that permits free use |
static int |
STATUS_PD
If the data free of copyright restrictions |
static int |
STATUS_UNKNOWN
If the data of unknown distribution status |
| Method Summary | |
java.lang.String |
getEdition()
The edition of this version, for example "Anglicised" (NIV), "Stephanus" (Greek). |
java.util.Date |
getFirstPublished()
The date of first publishing. |
java.lang.String |
getFullName()
The full name including edition of the version, for example "New International Version, Anglicised". |
java.lang.String |
getInitials()
The initials of the version - how most people will know it, for example "NIV", "KJV" |
java.net.URL |
getLicence()
Not sure about this one - Do we need a way of getting at the dist. |
java.lang.String |
getName()
The name of the version, for example "King James Version" or "Bible in Basic English" or "Greek". |
int |
getOpenness()
Is this version sold for commercial profit like the NIV, or kept open like the NET version. |
boolean |
isSameFamily(BookMetaData version)
Do the 2 versions have matching names. |
| Field Detail |
STATUS_UNKNOWN
public static final int STATUS_UNKNOWN
- If the data of unknown distribution status
- See Also:
- Constant Field Values
STATUS_PD
public static final int STATUS_PD
- If the data free of copyright restrictions
- See Also:
- Constant Field Values
STATUS_FREE
public static final int STATUS_FREE
- Does the data have a licence that permits free use
- See Also:
- Constant Field Values
STATUS_COPYABLE
public static final int STATUS_COPYABLE
- Is the data freely redistributable
- See Also:
- Constant Field Values
STATUS_COMMERCIAL
public static final int STATUS_COMMERCIAL
- Is the data sold for commercial profit
- See Also:
- Constant Field Values
| Method Detail |
getName
public java.lang.String getName()
- The name of the version, for example "King James Version" or
"Bible in Basic English" or "Greek". In general it should be
possible to deduce the initials from the name by removing all the
non-capital letters.
getEdition
public java.lang.String getEdition()
- The edition of this version, for example "Anglicised" (NIV),
"Stephanus" (Greek). For 2 versions to be equal both the name and
the edition must be equal. In general the text returned by this
method should not include the word "Edition"
getFullName
public java.lang.String getFullName()
- The full name including edition of the version, for example
"New International Version, Anglicised". The format is "name, edition"
isSameFamily
public boolean isSameFamily(BookMetaData version)
- Do the 2 versions have matching names.
getInitials
public java.lang.String getInitials()
- The initials of the version - how most people will know it, for
example "NIV", "KJV"
getFirstPublished
public java.util.Date getFirstPublished()
- The date of first publishing. This does not need to be accurate and
2 versions can be considered equal even if they have different
first publishing dates for that reason. In general "1 Jan 1970"
means published in 1970, and so on. A null return from this
method is entirely valid if the date of first publishing is not
known.
getOpenness
public int getOpenness()
- Is this version sold for commercial profit like the NIV, or kept
open like the NET version.
getLicence
public java.net.URL getLicence()
- Not sure about this one - Do we need a way of getting at the dist.
licence? Are we going to be able to tie it down to a single Version
policy like this?
|
|||||||||
| Home >> All >> org >> crosswire >> bible >> [ book overview ] | PREV CLASS NEXT CLASS | ||||||||
|
SUMMARY: JAVADOC | SOURCE | DOWNLOAD | NESTED | FIELD | CONSTR | METHOD |
DETAIL: FIELD | CONSTR | METHOD | ||||||||