/* ====================================================================
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for Additional information regarding copyright ownership.
The ASF licenses this file to You 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.
==================================================================== */
/* ================================================================
* About NPOI
* Author: Tony Qu
* Author's email: tonyqus (at) gmail.com
* Author's Blog: tonyqus.wordpress.com.cn (wp.tonyqus.cn)
* HomePage: http://www.codeplex.com/npoi
* Contributors:
*
* ==============================================================*/
using System;
using System.Collections.Generic;
using System.Text;
namespace HH.WMS.Utils.NPOI.POIFS.FileSystem
{
///
/// Class DocumentDescriptor
/// @author Marc Johnson (mjohnson at apache dot org)
///
public class DocumentDescriptor
{
private POIFSDocumentPath path;
private String name;
private int hashcode = 0;
///
/// Initializes a new instance of the class.
///
/// the Document path
/// the Document name
public DocumentDescriptor(POIFSDocumentPath path, String name)
{
if (path == null)
{
throw new NullReferenceException("path must not be null");
}
if (name == null)
{
throw new NullReferenceException("name must not be null");
}
if (name.Length== 0)
{
throw new ArgumentException("name cannot be empty");
}
this.path = path;
this.name = name;
}
///
/// Gets the path.
///
/// The path.
public string Path
{
get { return this.path.ToString(); }
}
///
/// Gets the name.
///
/// The name.
public string Name
{
get { return this.name; }
}
///
/// equality. Two DocumentDescriptor instances are equal if they
/// have equal paths and names
///
/// the object we're checking equality for
/// true if the object is equal to this object
public override bool Equals(Object o)
{
bool rval = false;
if ((o != null) && (o.GetType()== this.GetType()))
{
if (this == o)
{
rval = true;
}
else
{
DocumentDescriptor descriptor = ( DocumentDescriptor ) o;
rval = this.path.Equals(descriptor.path)
&& this.name.Equals(descriptor.name);
}
}
return rval;
}
///
/// Serves as a hash function for a particular type.
///
///
/// hashcode
///
public override int GetHashCode()
{
if (hashcode == 0)
{
hashcode = path.GetHashCode() ^ name.GetHashCode();
}
return hashcode;
}
///
/// Returns a that represents the current .
///
///
/// A that represents the current .
///
public override String ToString()
{
StringBuilder buffer = new StringBuilder(40 * (path.Length + 1));
for (int j = 0; j < path.Length; j++)
{
buffer.Append(path.GetComponent(j)).Append("/");
}
buffer.Append(name);
return buffer.ToString();
}
}
}