/*
    * Copyright 2012-2013 smartics, Kronseder & Reiner GmbH
    *
    * Licensed under the Apache License, Version 2.0 (the "License");
    * you may not use this file except in compliance with the License.
    * You may obtain a copy of the License at
    *
    *     http://www.apache.org/licenses/LICENSE-2.0
    *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  package de.smartics.properties.tutorial.property.key;
  
  import static org.hamcrest.MatcherAssert.assertThat;
  import static org.hamcrest.Matchers.is;
  
  import org.junit.Before;
  import org.junit.Test;
  
  import de.smartics.projectdoc.annotations.DocCategory;
  import de.smartics.projectdoc.annotations.Document;
  import de.smartics.projectdoc.annotations.topic.DocChapter;
  import de.smartics.properties.api.core.domain.PropertyKey;
  import de.smartics.properties.impl.config.classpath.ClasspathConfigurationProperties;
  import de.smartics.properties.impl.config.classpath.ClasspathConfigurationPropertiesFactory;
  
  /**
   * This tutorial shows how to set the name of a property by overriding the
   * default name derived from the method name. This technique is useful if the
   * syntax of your properties cannot be reflected in Java method names.
   */
  @Document(title = "Naming Property Keys", sortKey = "basics0073")
  @DocCategory({ "basics" })
  // @DocTopic(path="basics", step="73")
  public class PropertyKeyNamingTutorial
  {
    private ClasspathConfigurationProperties config; // NOPMD
  
    private KeyNameProperties properties;
  
    @Before
    public void setUp()
    {
      config = createConfiguration();
      properties = config.getProperties(KeyNameProperties.class);
    }
  
    private static ClasspathConfigurationProperties createConfiguration()
    {
      final ClasspathConfigurationPropertiesFactory factory =
          new ClasspathConfigurationPropertiesFactory();
      final ClasspathConfigurationProperties config = factory.create();
      config.addClassPathProperties(KeyNameProperties.class);
      return config;
    }
  
    /**
     * {@insertCode source="KeyNameProperties"}
     * <p>
     * Instead of the default name <code>storyPoint</code>, the name is
     * <code>story-point</code>.
     * </p>
     * {@insertCode}
     */
    @DocChapter
    @Test
    public void declarationOfAProperty()
    {
      final PropertyKey key = properties.storyPointPropertyKey();
      final Integer value = properties.storyPoint();
  
      assertThat(key.toString(), is("tutorial.property.key.story-point"));
      assertThat(key.getName(), is("story-point"));
      assertThat(key.getPropertySet(), is("tutorial.property.key"));
      assertThat(value, is(1));
    }
  }