View Javadoc
1   /*
2    * Copyright (C) 2010-2014 Hamburg Sud and the contributors.
3    *
4    * Licensed under the Apache License, Version 2.0 (the "License");
5    * you may not use this file except in compliance with the License.
6    * You may obtain a copy of the License at
7    *
8    * http://www.apache.org/licenses/LICENSE-2.0
9    *
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS,
12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13   * See the License for the specific language governing permissions and
14   * limitations under the License.
15   */
16  package org.aludratest.service.locator;
17  
18  import org.aludratest.exception.TechnicalException;
19  
20  /**
21   * Identifies a component of the SUT, for example a button in a GUI.
22   * @author Volker Bergmann
23   */
24  public abstract class Locator {
25  
26      protected final String locator;
27  
28      /** Constructor.
29       *  @param locator */
30      protected Locator(String locator) {
31          if (locator == null) {
32              throw new TechnicalException("Locator string is NULL");
33          }
34          this.locator = locator;
35      }
36  
37      // java.lang.Object overrides ----------------------------------------------
38  
39      @Override
40      public String toString() {
41          return locator;
42      }
43  
44      @Override
45      public int hashCode() {
46          return this.locator.hashCode();
47      }
48  
49      @Override
50      public boolean equals(Object obj) {
51          if (this == obj) {
52              return true;
53          }
54          if (obj == null || getClass() != obj.getClass()) {
55              return false;
56          }
57          Locator that = (Locator) obj;
58          return (this.locator.equals(that.locator));
59      }
60  
61  }