我的问题的简短版本:
如何在 Symfony2 中编辑子窗体的实体?
=-=-=-=-= 长而详细的版本 =-=-
我有一个实体订单
<?php
class Order
{
/**
* @var integer
*
* @ORMColumn(name="id", type="integer")
* @ORMId
* @ORMGeneratedValue(strategy="AUTO")
*/
private $id;
/**
* @ORMManyToOne(targetEntity="Customer")
* @ORMJoinColumn(name="customer_id", referencedColumnName="id", nullable=false)
**/
private $customer;
/**
* @var DateTime
*
* @ORMColumn(name="date", type="date")
*/
private $date;
/**
* @ORMManyToOne(targetEntity="AppBundleEntityOrderStatus")
* @ORMJoinColumn(name="order_status_id", referencedColumnName="id", nullable=false)
**/
private $orderStatus;
/**
* @var string
*
* @ORMColumn(name="reference", type="string", length=64)
*/
private $reference;
/**
* @var string
*
* @ORMColumn(name="comments", type="text")
*/
private $comments;
/**
* @var array
*
* @ORMOneToMany(targetEntity="OrderRow", mappedBy="Order", cascade={"persist"})
*/
private $orderRows;
...
}
MySQL
____ |ID |订单编号 | |customer_id |FK customer.id NOT NULL | |日期 |订购日期 | |order_status_id |fk order_status.id 不为空 | |参考资料 |瓦尔查尔订单参考 | |评论 |文本评论 | |___________________________________________________________|
和实体订单行(一个订单可以有一行或多行)
<?php
class OrderRow
{
/**
* @var integer
*
* @ORMColumn(name="id", type="integer")
* @ORMId
* @ORMGeneratedValue(strategy="AUTO")
*/
private $id;
/**
* @ORMManyToOne(targetEntity="Order", inversedBy="orderRows", cascade={"persist"})
* @ORMJoinColumn(name="order_id, referencedColumnName="id", nullable=false)
**/
private $order;
/**
* @ORMManyToOne(targetEntity="[MyShopBundleProductBundleEntityProduct")
* @ORMJoinColumn(name="product_id", referencedColumnName="id", nullable=true)
**/
private $product;
/**
* @var string
*
* @ORMColumn(name="description", type="string", length=255)
*/
private $description;
/**
* @var integer
*
* @ORMColumn(name="count", type="integer")
*/
private $count = 1;
/**
* @var DateTime
*
* @ORMColumn(name="date", type="date")
*/
private $date;
/**
* @var decimal
*
* @ORMColumn(name="amount", type="decimal", precision=5, scale=2)
*/
private $amount;
/**
* @var string
*
* @ORMColumn(name="tax_amount", type="decimal", precision=5, scale=2)
*/
private $taxAmount;
/**
* @var string
*
* @ORMColumn(name="discount_amount", type="decimal", precision=5, scale=2)
*/
private $discountAmount;
...
}
MySQL
____ |ID |订单编号 | |order_id |FK order.id NOT NULL | |product_id |FK product.id | |描述 |瓦尔查尔产品描述 | |计数 |整数计数 | |日期 |日期 | |金额 |金额 | |税额 |税额 | |折扣金额 |折扣金额 | |___________________________________________________________|
我想创建一个允许编辑一个订单及其行的表单。
订单类型.php
class OrderType extends AbstractType
{
/**
* @param FormBuilderInterface $builder
* @param array $options
*/
public function buildForm(FormBuilderInterface $builder, array $options)
{
$builder
->add('customer', 'entity', array(
'class' => 'Customer',
'multiple' => false
))
->add('orderStatus', 'entity', array(
'class' => 'AppBundleEntityOrderStatus',
'multiple' => false
))
->add('date')
->add('reference')
->add('comments')
->add('orderRows', 'collection', [
'type' => new OrderRowType(),
'allow_add' => true,
'by_reference' => false,
])
;
}
...
}
订单行类型.php
class OrderRowType extends AbstractType
{
/**
* @param FormBuilderInterface $builder
* @param array $options
*/
public function buildForm(FormBuilderInterface $builder, array $options)
{
$builder
->add('order', 'entity', array(
'class' => 'MyShopBundleOrderBundleEntityOrder',
'multiple' => false
))
->add('product', 'product_selector') // service
->add('orderRowStatus', 'entity', array(
'class' => 'AppBundleEntityOrderRowStatus',
'multiple' => false
))
->add('description')
->add('count')
->add('startDate')
->add('endDate')
->add('amount')
->add('taxAmount')
->add('discountAmount')
;
}
...
}
更新订单是通过向我的 API 发送请求来完成的:
- 请求网址:https://api.example.net/admin/orders/update/37
- 请求方法:开机自检
状态代码:200
Params: { "order[customer]": "3", "order[orderStatus]": "1", "order[date][month]:": "5", "order[date][day]": "18", "order[date][year]": "2015", "order[reference]": "Testing", "order[comments]": "I have nothing to say!", "order[orderRows][0][order]": "32", "order[orderRows][0][product]": "16721", "order[orderRows][0][orderRowStatus]:1": "1", "order[orderRows][0][description]": "8 GB memory", "order[orderRows][0][count]": "12", "order[orderRows][0][startDate][month]": "5", "order[orderRows][0][startDate][day]": "18", "order[orderRows][0][startDate][year]": "2015", "order[orderRows][0][endDate][month]": "5", "order[orderRows][0][endDate][day]": "18", "order[orderRows][0][endDate][year]": "2015", "order[orderRows][0][amount]": "122.03", "order[orderRows][0][taxAmount]": "25.63", "order[orderRows][0][discountAmount]": "0", "order[orderRows][1][order]": "32", "order[orderRows][1][product]": "10352", "order[orderRows][1][orderRowStatus]": "2", "order[orderRows][1][description]": "12 GB MEMORY", "order[orderRows][1][count]": "1", "order[orderRows][1][startDate][month]": "5", "order[orderRows][1][startDate][day]": "18", "order[orderRows][1][startDate][year]": "2015", "order[orderRows][1][endDate][month]": "5", "order[orderRows][1][endDate][day]": "18", "order[orderRows][1][endDate][year]": "2015", "order[orderRows][1][amount]": "30.8", "order[orderRows][1][taxAmount]": "6.47", "order[orderRows][1][discountAmount]": "0", "order[orderRows][2][order]": "32", "order[orderRows][2][product]": "2128", "order[orderRows][2][orderRowStatus]": "3", "order[orderRows][2][description]": "4GB MEMORY", "order[orderRows][2][count]": "5", "order[orderRows][2][startDate][month]": "5", "order[orderRows][2][startDate][day]": "18", "order[orderRows][2][startDate][year]": "2015", "order[orderRows][2][endDate][month]": "5", "order[orderRows][2][endDate][day]": "18", "order[orderRows][2][endDate][year]": "2015", "order[orderRows][2][amount]": "35.5", "order[orderRows][2][taxAmount]": "7.46", "order[orderRows][2][discountAmount]": "0" }
上面的请求编辑订单详细信息并创建新order_rows,因为未提供order_row_id。Noare 在 Symfony2 中,我发现我应该将$builder->add('id') 添加到我的 OrderRowType 中,我的实体也没有列 ID 的 setter。
在很多信息之后,我有一个非常简短的问题。我应该如何更新此表单中的order_rows记录?
如果您不了解内部结构,处理集合和教义有时可能会很复杂。我将首先为您提供一些有关内部结构的信息,以便您更清楚地了解幕后的工作。
很难从您提供的详细信息中估计实际问题,但我为您提供了一些可以帮助您调试问题的建议。我给出了一个广泛的答案,所以它可以帮助其他人。
TL;容灾版本
这是我的猜测:即使您将by_reference
设置为 false,您也正在通过引用修改实体。这可能是因为您尚未定义addOrderRow
和removeOrderRow
方法(两者都),或者因为您没有使用教义集合对象
一些内部结构
形式
当您在控制器中创建 Form 对象时,将其与您从数据库中检索的实体(即使用 ID)或您刚刚创建的实体绑定:这意味着表单不需要主实体的 ID,也不需要集合对象的ID。为了方便起见,您可以将其添加到表单中,但如果您确实确保它们是不可变的(例如hidden
带有disabled => true
选项的类型)。
当创建集合表单时,Symfony会自动为实体集合中已经存在的每个实体创建一个子表单;这就是为什么在entity/<id>/edit
操作中,您(应该)始终看到集合中已经存在的元素的可编辑表单。
allow_add
和allow_delete
选项控制是否可以通过删除集合的某些元素或添加新元素来动态调整生成的子窗体的大小(请参阅ResizeFormListener
类)。请注意,当您将prototype
与 javascript 一起使用时,必须谨慎使用__prototype__
占位符:这是用于重新映射对象服务器端的实际key
,因此如果您更改它,Form 将在集合中创建一个新元素。
学说
在教义中,你需要好好注意映射的owning side
和inverse side
。owning
端是将保持与数据库关联的实体,而反端是另一个实体。持久化时,owning
端是唯一触发要保存的关系的 ONLY。在对象修改期间,保持两个关系同步是一种模型责任。
在处理一对多关系时,owning
方是many
(例如OrderRow
在你的情况下是s),one
是inverse
方。
最后,应用程序需要显式标记要保留的实体。关系的两边都可以标记为persist cascading
,这样通过关系的所有可到达的实体也被持久化。在此过程中,将自动保留所有新实体,并且(在标准配置中)更新所有"脏"实体。
脏实体的概念在官方文档中得到了很好的解释。默认情况下,Doctrine 通过将每个属性与原始状态进行比较来自动检测更新的实体,并在刷新期间生成UPDATE
语句。如果明确表示这是为了提高性能(即@ChangeTrackingPolicy("DEFERRED_EXPLICIT")
),必须手动保留所有实体,即使关系被标记为级联也是如此。
另请注意,从数据库重新加载实体时,Doctrine 使用PersistenCollection
实例来处理集合,因此您需要使用 Doctrine 集合接口来处理实体集合。
要检查的内容
总而言之,这里有一个(希望是完整的)检查正确集合更新的事项列表。
教义关系的双方都设置得当
- 拥有端和反侧都应标记为级联持续(如果不是,控制器必须手动级联...不建议使用,除非太慢);
- 集合属性必须是
DoctrineCommonCollection
的实现,而不是一个简单的数组; - 模型必须在每次更改时相互更新,因此这意味着
- 集合对象不应按原样返回,以避免通过引用进行修改。
在您的情况下:
<?php
class Order
{
/**
* @var integer
*
* @ORMColumn(name="id", type="integer")
* @ORMId
* @ORMGeneratedValue(strategy="AUTO")
*/
private $id;
/**
* @var DoctrineCommonCollectionsCollection
* @ORMOneToMany(targetEntity="OrderRow", mappedBy="Order", cascade={"persist"})
*/
private $orderRows;
public function __construct()
{
// this is required, as Doctrine will replace it by a PersistenCollection on load
$this->orderRows = new DoctrineCommonCollectionsArrayCollection();
}
/**
* Add order row
*
* @param OrderRow $row
*/
public function addOrderRow(OrderRow $row)
{
if (! $this->orderRows->contains($row))
$this->orderRows[] = $row;
$row->setOrder($this);
}
/**
* Remove order row
*
* @param OrderRow $row
*/
public function removeOrderRow(OrderRow $row)
{
$removed = $this->orderRows->removeElement($row);
/*
// you may decide to allow your domain to have spare rows, with order set to null
if ($removed)
$row->setOrder(null);
*/
return $removed;
}
/**
* Get order rows
* @return OrderRow[]
*/
public function getOrders()
{
// toArray prevent edit by reference, which breaks encapsulation
return $this->orderRows->toArray();
}
}
class OrderRows
{
/**
* @var integer
*
* @ORMColumn(name="id", type="integer")
* @ORMId
* @ORMGeneratedValue(strategy="AUTO")
*/
private $id;
/**
* @var Order
* @ORMManyToOne(targetEntity="Order", inversedBy="orderRows", cascade={"persist"})
* @ORMJoinColumn(name="order_id, referencedColumnName="id", nullable=false)
*/
private $order;
/**
* Set order
*
* @param Order $order
*/
public function setOrder(Order $order)
{
// avoid infinite loops addOrderRow -> setOrder -> addOrderRow
if ($this->order === $order) {
return;
}
if (null !== $this->order) {
// see the comment above about spare order rows
$this->order->removeOrderRow($this);
}
$this->order = $order;
}
/**
* Get order
*
* @return Order
*/
public function getOrder()
{
return $this->order;
}
}
表单集合配置正确
- 确保表单未公开订单
id
(但在模板中包含路由器操作的正确GET
参数) - 确保 OrderRow
order
不存在,因为这将由模型类自动更新 - 确保
by_reference
设置为false
- 确保
addOrderRow
和removeOrderRow
都定义了Order
类 - 若要加快调试速度,请确保
Order::getOrderRows
不直接返回集合
这里是片段:
class OrderType extends AbstractType
{
public function buildForm(FormBuilderInterface $builder, array $options)
{
$builder
->add('orderRows', 'collection', [
'type' => new OrderRowType(),
'allow_add' => true, // without, new elements are ignored
'allow_delete' => true, // without, deleted elements are not updated
'by_reference' => false, // hint Symfony to use addOrderRow and removeOrderRow
// NOTE: both method MUST exist, or Symfony will ignore the option
])
;
}
}
class OrderRowType extends AbstractType
{
public function buildForm(FormBuilderInterface $builder, array $options)
{
$builder
// ->add('order') NOT required, the model will handle the setting
->add('product', 'product_selector') // service
;
}
}
控制者必须正确更新实体
- 确保表单创建正确;
- 如果使用
Form::handleRequest
请确保 HTTP 方法与表单方法属性匹配 - 如果表单有效,请处理集合的已删除元素
- 如果表单有效,请保留实体然后刷新
在您的情况下,您应该有这样的操作:
public function updateAction(Request $request, $id)
{
$em = $this->getDoctrine()->getManager();
$order = $em->getRepository('YourBundle:Order')->find($id);
if (! $order) {
throw $this->createNotFoundException('Unable to find Order entity.');
}
$previousRows = $order->getOrderRows();
// is a PUT request, so make sure that <input type="hidden" name="_method" value="PUT" /> is present in the template
$editForm = $this->createForm(new OrderType(), $order, array(
'method' => 'PUT',
'action' => $this->generateUrl('order_update', array('id' => $id))
));
$editForm->handleRequest($request);
if ($editForm->isValid()) {
// removed rows = previous rows - current rows
$rowsRemoved = array_udiff($previousRows, $order->getOrderRows(), function ($a, $b) { return $a === $b ? 0 : -1; });
// removed rows must be deleted manually
foreach ($rowsRemoved as $row) {
$em->remove($row);
}
// if not cascading, all rows must be persisted as well
$em->flush();
}
return $this->render('YourBundle:Order:edit.html.twig', array(
'entity' => $order,
'edit_form' => $editForm->createView(),
));
}
希望这有帮助!
我不认为这是不可能的,原因如下:
OrderRows仅由其ID标识,因此为了使Doctrine知道实际更新了哪个实体,需要知道id。但是,您需要将 OrderRow ID 添加为字段,您不想这样做,因为这将允许更改不属于该订单的"外部"OrderRows。(无需复杂的权限检查)
解决方案是完全删除旧的订单行并插入新的订单行。插入已经有效:-)。
删除实体在说明书中的">原则:确保数据库持久性"下进行了描述
只有一个小缺点:订单更新时,OrderRows会获得新的ID。
mappedBy 应该是order 而不是Order,因为它指向一个属性而不是一个类名。
/**
* @var array
*
* @ORMOneToMany(targetEntity="OrderRow", mappedBy="order", cascade={"persist"})
*/
private $orderRows;