Oynatma Çerçevesi 2.4 [-A] ile OWrites [-A], Biçim [A] - OFormat [A] arasında yazar. Amaç?

Question

PlayFramework Json kütüphanesinde Writes [-A] ve OWrites [-A] arasındaki fark nedir? Writes'i kullandım [A] ama OWrites'in amacının ne olduğunu anlayamıyorum. Aynı soru Format [A] ve OFormat [A] için de geçerlidir.

Kaynak kodu here for Writes ve here for Formats bulunabilir. Onlara baktım ama onların kullanımlarındaki farkı anlayamıyorum.

Answer 1

Çoğu zaman bir kodlayıcının her zaman bir JSON nesnesini (isteğe bağlı bir JSON değerinin aksine) üreteceğini biliyorsunuzdur. Bu gerçeği tip sistemde izlemek, normalde gerekli olacak olan çemberler içinden atlamaksızın böyle bir kodlayıcının çıktısı ile çalışmayı mümkün kılar.

Örneğin, elimizdeki basit bir sınıfı varsayalım:

class Foo(val name: String, val age: Long) 

Ve böyle bir Writes örneği yazma:

scala> val json = fooWrites.writes(new Foo("McBar", 101)) 
json: play.api.libs.json.JsValue = {"name":"McBar","age":101} 

:

import play.api.libs.functional.syntax._ 
import play.api.libs.json._ 

implicit val fooWrites: Writes[Foo] = (
    (__ \ 'name).write[String] and (__ \ 'age).write[Long] 
)(foo => (foo.name, foo.age)) 

Şimdi aşağıdaki yazabilirsiniz

Şimdi hangi sebepten dolayı alan adlarının bir listesini almak istediğimizi varsayalım. Bunun yerine

scala> json.as[JsObject].keys 
res0: scala.collection.Set[String] = Set(name, age) 

:

scala> json.keys 
<console>:17: error: value keys is not a member of play.api.libs.json.JsValue 
       json.keys 
       ^

Ama tabii biz json daima JsObject olacağını biliyoruz Biz böyle bir şey yazmak zorunda. Sorun derleyici değil. OWrites bunu düzeltir.

implicit val fooWrites: OWrites[Foo] = (
    (__ \ 'name).write[String] and (__ \ 'age).write[Long] 
)(foo => (foo.name, foo.age)) 

Ve sonra:

scala> val json = fooWrites.writes(new Foo("McBar", 101)) 
json: play.api.libs.json.JsObject = {"name":"McBar","age":101} 

scala> json.keys 
res1: scala.collection.Set[String] = Set(name, age) 

OWrites üzerinde writes çıkışı statik bir JsObject olarak yazıldığında, bu yüzden güvensiz as[JsObject] döküm olmadan .keys kullanabilirsiniz.

(Bir yan not olarak, alt sınıflar yöntem dönüş tipleri daha spesifik yapma not personally a fan değilim, ben circe bu sorunu çözmek için a slightly different approach attık.)