unidue.ub.statistics.eUsage

Class CounterDAO

java.lang.Object

unidue.ub.statistics.eUsage.CounterDAO

public class CounterDAO
extends java.lang.Object

Methods to persist and access Counter objects by JPA queries.

Author:

Spielberg

Constructor Summary

Constructors

Constructor and Description
CounterDAO()

Method Summary

Modifier and Type	Method and Description
boolean	contains(java.lang.String issn, int year, int month, javax.persistence.EntityManager em) checks, whether a specific Counter object is in the database
static void	deleteSingleCounter(java.lang.String issn, int year, int month, javax.persistence.EntityManager em) deletes a single Counter object from the database
static java.util.List<Counter>	getCounters(java.lang.String onlineISSN) retrieves a list of Counter objects for one journal from the database
static java.util.List<Counter>	getCountersForYear(java.lang.String issn, int year, javax.persistence.EntityManager em) retrieves a list of Counter objects for one journal and one year from the database
static Counter	getSingleCounter(java.lang.String issn, int year, int month, javax.persistence.EntityManager em) retrieves a single Counter object from the database
static long	getYearlyTotalRequests(java.lang.String issn, int year, javax.persistence.EntityManager em) returns the sum of all types of request within a given year
static void	persistCounter(Counter counter) Persists a counter objects to the database
static void	persistCounter(java.util.List<Counter> counters) persists a list of Counter objects to the database

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CounterDAO

public CounterDAO()

Method Detail

persistCounter

public static void persistCounter(Counter counter)

Persists a counter objects to the database

Parameters:

counter - the counter to be persisted

contains

public boolean contains(java.lang.String issn,
                        int year,
                        int month,
                        javax.persistence.EntityManager em)

checks, whether a specific Counter object is in the database

Parameters:

issn - the ISSN of the journal to be checked

year - the year of the COUNTER statistics

month - the month of the COUNTER statistics

em - the entity manager for the database

Returns:

boolean true, if the database contains the desired COUNTER statistics

getSingleCounter

public static Counter getSingleCounter(java.lang.String issn,
                                       int year,
                                       int month,
                                       javax.persistence.EntityManager em)

retrieves a single Counter object from the database

Parameters:

issn - the ISSN of the journal to be checked

year - the year of the COUNTER statistics

month - the month of the COUNTER statistics

em - the entity manager for the database

Returns:

Counter the desired COUNTER statistics. Returns null if the statistics is not found or more than one exist.

getCountersForYear

public static java.util.List<Counter> getCountersForYear(java.lang.String issn,
                                                         int year,
                                                         javax.persistence.EntityManager em)

retrieves a list of Counter objects for one journal and one year from the database

Parameters:

issn - the ISSN of the journal to be checked

year - the year of the COUNTER statistics

em - the entity manager for the database

Returns:

the desired COUNTER statistics. Returns null if the statistics is not found.

getYearlyTotalRequests

public static long getYearlyTotalRequests(java.lang.String issn,
                                          int year,
                                          javax.persistence.EntityManager em)

returns the sum of all types of request within a given year

Parameters:

issn - the ISSN of the journal to be checked

year - the year of the COUNTER statistics

em - the entity manager for the database

Returns:

long the total number of successful requests

deleteSingleCounter

public static void deleteSingleCounter(java.lang.String issn,
                                       int year,
                                       int month,
                                       javax.persistence.EntityManager em)

deletes a single Counter object from the database

Parameters:

issn - the ISSN of the journal to be checked

year - the year of the COUNTER statistics

month - the month of the COUNTER statistics

em - the entity manager for the database

persistCounter

public static void persistCounter(java.util.List<Counter> counters)

persists a list of Counter objects to the database

Parameters:

counters - the list of COUNTER statistics to be persisted

getCounters

public static java.util.List<Counter> getCounters(java.lang.String onlineISSN)

retrieves a list of Counter objects for one journal from the database

Parameters:

onlineISSN - the ISSN of the journal to be checked

Returns:

the desired COUNTER statistics. Returns null if the statistics is not found.