JPA: блокировка при выполнении косвенной вставки
Я пишу программный продукт, который отслеживает использование лекарств. Я использую JPA для взаимодействия с базой данных. Моя модель состоит из двух объектов:Prescription
иDose
, каждыйPrescription
имеет коллекциюDose
случаи, которые представляют дозы, данные пациенту как часть этого предписания, вот так:
Prescription.java
@Entity
@XmlRootElement
public class Prescription {
private long id;
private Collection<Dose> doses = new ArrayList<Dose>();
/**
* Versioning field used by JPA to track concurrent changes.
*/
private long version;
// Other properties omitted...
@Id
@GeneratedValue(strategy = GenerationType.TABLE)
public long getId() {
return id;
}
public void setId(long id) {
this.id = id;
}
// We specify cascade such that when we modify this collection, it will propagate to the DOSE table (e.g. when
// adding a new dose to this collection, a corresponding record will be created in the DOSE table).
@OneToMany(mappedBy = "prescription", cascade = CascadeType.ALL)
public Collection<Dose> getDoses() {
// todo update to list or collection interface.
return doses;
}
public void setDoses(Collection<Dose> doses) {
this.doses = doses;
}
@Version
public long getVersion() {
return version;
}
/**
* Application code should not call this method. However, it must be present for JPA to function.
* @param version
*/
public void setVersion(long version) {
this.version = version;
}
}
Dose.java
@Entity
@XmlRootElement
public class Dose {
private long id;
private Prescription prescription;
// Other properties omitted...
@Id
@GeneratedValue(strategy = GenerationType.TABLE)
public long getId() {
return id;
}
public void setId(long id) {
this.id = id;
}
@XmlTransient
@ManyToOne
@JoinColumn(name = "PRESCRIPTION_ID") // Specifies name of column pointing back to the parent prescription.
public Prescription getPrescription() {
return prescription;
}
public void setPrescription(Prescription prescription) {
this.prescription = prescription;
}
}
A Dose
может существовать только в контекстеPrescription
и, следовательно,Dose
вставляется в базу данных косвенным путем, добавляя ее в набор доз по рецепту:
DoseService.java
@Stateless
public class DoseService {
@PersistenceContext(unitName = "PrescriptionUnit")
private EntityManager entityMgr;
/**
* Insert a new dose for a given prescription ID.
* @param prescriptionId The prescription ID.
* @return The inserted {@code Dose} instance if insertion was successful,
* or {@code null} if insertion failed (if there is currently no doses available for the given prescription ID).
*/
@TransactionAttribute(value = TransactionAttributeType.REQUIRED)
public Dose addDose(long prescriptionId) {
// Find the prescription.
Prescription p = entityMgr.find(Prescription.class, prescriptionId);
if (p == null) {
// Invalid prescription ID.
throw new IllegalArgumentException("Prescription with id " + prescriptionId + " does not exist.");
}
// TODO is this sufficient locking?
entityMgr.lock(p, LockModeType.OPTIMISTIC_FORCE_INCREMENT);
Dose d = null;
if (isDoseAvailable(p)) {
// A dose is available, create it and insert it into the database.
d = new Dose();
// Setup the link between the new dose and its parent prescription.
d.setPrescription(p);
p.getDoses().add(d);
}
try {
// Flush changes to database.
entityMgr.flush();
return d;
} catch (OptimisticLockException ole) {
// Rethrow application-managed exception to ensure that caller will have a chance of detecting failure due to concurrent updates.
// (OptimisticLockExceptions can be swallowed by the container)
// See "Recovering from Optimistic Failures" (page 365) in "Pro JPA 2" by M. Keith and M. Schincariol for details.
throw new ChangeCollisionException();
}
}
/**
* Checks if a dose is available for a given prescription.
* @param p The prescription for which to look up if a dose is available.
* @return {@code true} if a dose is available, {@code false} otherwise.
*/
@TransactionAttribute(value = TransactionAttributeType.MANDATORY)
private boolean isDoseAvailable(Prescription p) {
// Business logic that inspects p.getDoses() and decides if it is safe to give the patient a dose at this time.
}
}
addDose(long)
может быть вызвано одновременно. Решая, доступна ли доза, бизнес-логика проверяет набор доз по рецепту. Транзакция должна завершиться неудачей, если эта коллекция одновременно изменена (например, путем одновременного вызоваaddDose(long)
). Я используюLockModeType.OPTIMISTIC_FORCE_INCREMENT
для достижения этого (вместо получения блокировки таблицы на столе DOSE). ВPro JPA 2 Китом и Шинкариолом Я прочитал это:
Блокировка записи гарантирует все, что делает оптимистическая блокировка чтения, но также обязуется увеличивать поле версии в транзакции независимо от того, обновил ли пользователь объект или нет. [...] распространенным случаем использования OPTIMISTIC_FORCE_INCREMENT является обеспечение согласованности между изменениями отношений сущностей (часто это отношения «один ко многим» с целевыми внешними ключами), когда в объектной модели изменяются указатели отношений сущностей, но в модели данных столбцы в таблице сущностей не изменяются.
Правильно ли я понимаю этот режим блокировки? Моя текущая стратегия гарантирует, чтоaddDose
транзакция потерпит неудачу, если в ЛЮБОЙ дозе рецепта произойдет ЛЮБОЕ изменение (будь то добавление, удаление или обновление какой-либо дозы в коллекции)?