Новый DSL (обсуждение)

[take-five]

Предположим, у нас есть XML-документ следующей структуры:

<?xml version="1.0" encoding="utf-8"?>
<shop>
  <categories>
    <category id="1">Electronics</category>
    <category id="2" parentId="1">Phones</category>
  </categories>

  <offers>
    <offer id="1" available="true">
      <name>iPhone 5</name>
      <categoryId>2</categoryId>
      <price currencyId="RUR">25000</price>
      <params>
        <param name="Color">White</param>
        <param name="Battery">2000 mA/h</param>
      </params>
    </offer>

    <offer>...</offer>
  </offers>
</shop>

Предлагается следующее API для создания парсера документа такой структуры:

parser = Ox::Mapper.document do
  # map означает, что по элементам с таким именем будет производиться итерация
  # :scope => :categories означает, что итерация будет производиться только по элементам
  # <category>, которые находятся внутри элементов <categories>
  map :category, :scope => :categories do
    # из элемента category мы берем атрибуты id и parentId, причем ко второму можно будет обратиться по имени parent_id
    attributes :id, :parentId => :parent_id
  end

  # :scope => '/shop/offers' означает, что итерация будет производиться только по элементам <offer>,
  # вложенным в элемент <offers>, вложенный в элемент <shop>, являющимся корневым
  map :offer, :scope => '/shop/offers' do
    attribute :id
    attribute :available

    # element_value означает, что из элемента <name> мы берем только его текст. к этому значению можно будет обратиться так - element[:name]
    element_value :name
    element_value :categoryId, :as => :category_id
    element :price do
      attribute :currencyId, :as => :currency_id
    end

    # множество однотипных элементов можно отобразить в коллекцию (массив)
    collection :params do
      element :param, :attributes => :name
    end
  end
end

parser.parse(STDIN) do |tag|
  case tag.name
    when :category
      p [tag.name, tag[:id], tag[:parent_id]]

    when :offer
      p [
        tag[:id],
        tag[:available],
        tag[:name],
        tag[:category_id],
        tag[:price][:currency_id], # вот это меня смущает
        tag[:price].text, # и это тоже
        tag[:params][0][:name],
        tag[:params][0].text,
        tag[:params][1][:name],
        tag[:params][1].text
      ]
  end
end

Очень приветствуются замечания и дополнения.

[vkuznetsov]

надо в map или параметр с названием вложенных элементов передавать
или делать как-то так:

map :categories do
  element :category do
    attributes :id, :parentId => :parent_id
  end
end

[take-five]

@vkuznetsov обновил

[Strech]

А почему у тебя обращение не вот такое?

parser.parse(STDIN) do |tag|
  case tag.name
    when :category
      p [tag.name, tag.id, tag.parent_id]

    when :offer
      p [
        tag.id,
        tag.available,
        tag.name,
        tag.category_id,
        tag.price.currency_id,
        tag.price.text,
        tag.params[0].name,
        tag.params[0].text,
        tag.params[1].name,
        tag.params[1].text
      ]
  end
end

[take-five]

@Strech можно, конечно, и использовать method_missing, но это будет не оч. быстро, да и непонятно тогда, как быть, если встретится атрибут text

[Strech]

@take-five А если без миссинга, а по карте создавать методы доступа?
Ну и можно системные методы доступа типа text завернуть ...

[take-five]

@Strech да можно и так, только не в первую очередь

Я все же сначала хочу сделать хороший DSL для описания структуры документа

[Strech]

А что есть для namespace?

<stream:stream xmlns='jabber:client' xmlns:stream='http://etherx.jabber.org/streams' xml:lang='en' id='33758cb8-0122-4f54-8807-2936de0e20f4' from='vines.machines.dev' version='1.0'>

или

<stream:features><starttls xmlns="urn:ietf:params:xml:ns:xmpp-tls"><required/></starttls></stream:features>

[take-five]

Можно то же самое, только строками:

Ox::Mapper.document do
  map 'stream:stream' do
  end
end

Можно передавать параметр:

Ox::Mapper.document do
  map :stream, :namespace => :stream do
  end
end

Можно делать, как в рельсе:

Ox::Mapper.document do
  namespace :stream do
    map :stream do
    end
  end
end

Как лучше?

[Strech]

Мне понравились вариант 1 и 2, 3-ий выглядит запутано

А еще вопрос, т.е для доступа к <required/> из второго примера, мне надо написать так?

Ox::Mapper.document do
  map :stream, :namespace => :features do
    map :starttls do
      element :required
    end
  end
end

[take-five]

Не оч. понял, а что именно ты хочешь получить из второго примера?

[Strech]

Элемент required да/нет есть он или нет starttls.requred

[take-five]

Тогда так

Ox::Mapper.document do
  map :starttls, :scope => 'stream:features' do
    element :required
  end
end

[Strech]

Нормально вроде бы

[vkuznetsov]

👍

[Strech]

👍