Hadoop-0.20.0源代码分析（02）

UserGroupInformation类定义了一个与文件系统相关的用户和组信息抽象的内容，Hadoop框架实现了一个基于Unix系统的用户和组信息的实现类UnixUserGroupInformation，该类继承自UserGroupInformation抽象类。

从UserGroupInformation抽象类与其子类UnixUserGroupInformation的属性字段可以看出，抽象类所定义的功能信息重心在，描述一个登录以后获得的UserGroupInformation实例，而UnixUserGroupInformation类主要是侧重于登录前的信息的处理。首先看一下UnixUserGroupInformation类中定义的属性：

public static final String DEFAULT_USERNAME = "DrWho"; public static final String DEFAULT_GROUP = "Tardis"; final static private HashMap<String, UnixUserGroupInformation> user2UGIMap = new HashMap<String, UnixUserGroupInformation>(); private String userName; private String[] groupNames; final private static String UGI_TECHNOLOGY = "STRING_UGI";

前面两个是默认的Unix用户名DEFAULT_USERNAME和组名DEFAULT_GROUP，另外其中用户名userName和组名groupNames是根据UnixUserGroupInformation类构造方法设置的，这样保证了即使无法得到用户和组的信息，也能够使用默认的值去填充，比较适合用于测试，快速定位到用户名和组名的设置处。

第二个属性user2UGIMap是一个<用户名, 用户和组信息实例>的Map，用来快速获取到用户和组的信息。

最后一个UGI_TECHNOLOGY定义读获取用户和组信息的方式，显然该类中默认使用从文本中读取字符串的方式来构造。

对于UnixUserGroupInformation类实例的构造，该类给出了四个方法：

public UnixUserGroupInformation() { } public UnixUserGroupInformation(String userName, String[] groupNames) { setUserGroupNames(userName, groupNames); } /** * 根据一个或多个包含了“用户名和组名”的字符串的来构造UnixUserGroupInformation实例。 */ public UnixUserGroupInformation(String[] ugi) { if (ugi==null || ugi.length < 2) { throw new IllegalArgumentException( "Parameter does contain at least "+ "one user name and one group name"); } public static UnixUserGroupInformation createImmutable(String[] ugi) { return new UnixUserGroupInformation(ugi) { public void readFields(DataInput in) throws IOException { throw new UnsupportedOperationException(); } }; } String[] groupNames = new String[ugi.length-1]; System.arraycopy(ugi, 1, groupNames, 0, groupNames.length); setUserGroupNames(ugi[0], groupNames); }

该类实现了其抽象基类定义的两个抽象方法，用来获取用户名和组名，如下所示：

public String[] getGroupNames() { return groupNames; } public String getUserName() { return userName; }

UserGroupInformation抽象类实现了org.apache.hadoop.io.Writable接口，并没有在其中实现序列化操作的两个方法，所以在其子类UnixUserGroupInformationg给出了实现，如下：

/** * 反序列化重组（this）对象 */ public void readFields(DataInput in) throws IOException { // 首先读取UGI类型，默认就是从文本读字符串的类型 String ugiType = Text.readString(in); if (!UGI_TECHNOLOGY.equals(ugiType)) { throw new IOException("Expect UGI prefix: " + UGI_TECHNOLOGY + ", but receive a prefix: " + ugiType); } // 从DataInput in流对象中读取用户和组的信息 userName = Text.readString(in); int numOfGroups = WritableUtils.readVInt(in); groupNames = new String[numOfGroups]; for (int i = 0; i < numOfGroups; i++) { groupNames[i] = Text.readString(in); } } /** * 序列化（this）对象，写入到DataOutput out输出流中 */ public void write(DataOutput out) throws IOException { // 将UGI_TECHNOLOGY写入到DataOutput out中，写入位置是字节流的最前面 Text.writeString(out, UGI_TECHNOLOGY); // 写入操作 Text.writeString(out, userName); WritableUtils.writeVInt(out, groupNames.length); for (String groupName : groupNames) { Text.writeString(out, groupName); } }

 下面两个方法，将用户和组的信息以字符串的形式存到Hadoop的配置类Configuration实例中，也能从一个给定的Configuration类实例中读取出来：

public static void saveToConf(Configuration conf, String attr, UnixUserGroupInformation ugi ) { conf.set(attr, ugi.toString()); // 通过键值对的形式存储 } public static UnixUserGroupInformation readFromConf(Configuration conf, String attr) throws LoginException { String[] ugi = conf.getStrings(attr); // 从conf中读取用户和组信息字符串 if(ugi == null) { return null; } UnixUserGroupInformation currentUGI = null; if (ugi.length>0 ){ currentUGI = user2UGIMap.get(ugi[0]); // 根据从配置实例中读取到的用户名，从user2UGIMap中获取一个UnixUserGroupInformation实例 } if (currentUGI == null) { try { currentUGI = new UnixUserGroupInformation(ugi); // 如果user2UGIMap中不存在从conf中读取用户对应的UnixUserGroupInformation实例，直接根据字符串信息构造一个 user2UGIMap.put(currentUGI.getUserName(), currentUGI); // 同时加入到user2UGIMap中 } catch (IllegalArgumentException e) { throw new LoginException("Login failed: "+e.getMessage()); } } return currentUGI; }

与执行Unix系统的Shell命令相关的三个方法，介绍如下：

/** * 模拟Unix系统的Shell命令whoami来获取当前用户名 */ static String getUnixUserName() throws IOException { String[] result = executeShellCommand(new String[]{Shell.USER_NAME_COMMAND}); // 调用executeShellCommand()方法 if (result.length!=1) { throw new IOException("Expect one token as the result of " + Shell.USER_NAME_COMMAND + ": " + toString(result)); } return result[0]; } /** * 模拟Unix系统的Shell命令groups来获取和当前用户相关的组列表信息 */ private static String[] getUnixGroups() throws IOException { return executeShellCommand(Shell.getGROUPS_COMMAND()); } /* 根据输入的Unix系统Shell命令，模拟Unix系统执行 */ private static String[] executeShellCommand(String[] command) throws IOException { String groups = Shell.execCommand(command); StringTokenizer tokenizer = new StringTokenizer(groups); int numOfTokens = tokenizer.countTokens(); String[] tokens = new String[numOfTokens]; for (int i=0; tokenizer.hasMoreTokens(); i++) { tokens[i] = tokenizer.nextToken(); } return tokens; }

 上面三个方法能够模拟执行Unix系统的Shell命令，与Hadoop框架中实现的工具类org.apache.hadoop.util.Shell类密切相关，执行Unix系统的Shell命令的实现有一点点复杂，可以参考其工具类实现。

上面分析与登录系统之前用户和组信息的获取实现。当一个用户具备了充分的信息，可以登录文件系统进行特定的操作。下面就分析执行登录的过程了，有三个实现方法，基本原理都是一致的，下面给出这三个方法的声明及其说明：  /** * 通过模拟Unix系统执行Shell命令获取用户名和组名信息，执行登录动作。 */ public static UnixUserGroupInformation login() throws LoginException; /** * 调用readFromConf方法从conf中获取UGI； * 若不为UGI != null，则根据save来决定是否将UGI存储到conf中； * 若UGI == null，调用无参Login()方法登录，返回不为null的UGI，并根据save来决定是否将UGI存储到conf中。 */ public static UnixUserGroupInformation login(Configuration conf, boolean save) throws LoginException; /** * 设置save = false，调用login(conf, save)执行登录动作，也就是不把用户和组信息保存到conf中。 */ public static UnixUserGroupInformation login(Configuration conf) throws LoginException;

 最后，该类还有一个用于比较两个UGI是否相同的方法public boolean equals(Object other)。

 总结一下，UnixUserGroupInformation类主要对登录前的用户名和组名信息进行格式化，使用两种方式来获取：

1、通过从Hadoop的配置类实例中获取到用户名和组名；

2、模拟执行Unix系统Shell命令获取到 用户名和组名。